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He's busy doing a software 
update on 1,037 computers. 


Hard to tell though, isn t it? That’s because he’s 
automating it using FileWave® software. Totally 
cross-platform, totally automated. So, are you an 
IT administrator? Tired of manually installing OS 
updates, security updates and patches? Or 
maybe you just aren't keeping your software up 
to date? Automate it with FileWave® and save 
time for the important things. 

Hundreds of satisfied customers agree: 
FileWave® just works. 
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-flro/n the Editor 


JH ay is a fine time to catch up on spring cleaning, get outside a bit more (well, for 
mM mm those of us in the Northern Hemisphere) and to finish off projects that you've put 
mmmm off for too long, like OS 10,5, iTie Leopard delay has been written about extensively 
m M at tliis point. Frankly, we're all thankful for this at MacTech, We’d rather see a better 

■ W ■ product go gold than one that got rushed out the door. October will be here Itcfore 
you know it, and MacTech will l>e covering Leopard when it ships. 

Back in the present, we have enough articles 10 keep you in the know, fm very happy to 
have an nrricle introducing FScript written by the author of FScript himself! Created by Philippe 
Moughi FScript is a Smalltalk-inspired scripting language that lets you poke around the bowels 
of your Mac, prtxlding live data structures and giving you nearly unrivaled control. Some 
commercial applications, such as Colloquy and Day life, have even adopted FScript as a plug-in 
or internal scripting language. 

Jose Cruz presents us with two (TWO!) articles this month. First, he shows us how to 
integrate perl 6 into XCode. Perl is such a useful scripting language, perhaps getting a little 
overshadowed by some of the newer languages, such as Python and Ruby, but it’s still ingrained 
in many people's minds (and lingers). Of course, version 6 adds even more to the solid 
foundation that it already has. Switching scripting languages, Jose shows us a way to create an 
uninstaller using AppleScript and AppleScript studio. He brings solid reasons why you may 
want to do this, especially if your installer may not Ik 1 built with Apple's packaging tools.,, or 
even if it is. 

Check exit Mike Harvey’s review of 3Ware’s Sidecar external SATA disk, lie lays out why 
this is such a nice piece of gear Having rolled this out at a client or two, its a perfect fit IxXween 
“Firewire isn't good enough” and “ an Xserve PAID is too expensive". 

Criss Myers returns with another article that hits the lower-level components of the system 
we use every day. As we work through the Intel transition, another major component has been 
replaced; OpenFirmware is no more, being replaced by EFI Criss guides us to what's new, and 
what you need to know. 

Last, but not least, we give our best wishes to author Ben Waidie who runs his last article 
in his column this month. However, it's not goodbye! Ben will still lie doing what he does best: 
automate workflows using AppleScript. He'll hopefully have enough time to grace us with some 
more words of wisdom from time to lime. He will continue to be found through his website at 
http://www, a utomatedworkflows, com. Thanks for many, many excellent articles, Ben! 

Find this and more, including this month's MacTech Spoilighi on Paul Kafasis from Rogue 
Amoeba, inside! 


Edward Marczak 
Executive Editor 




This issue is dedicated to everyone at Virginia Tech. 

As we were putting the finishing touches on this issue, we learned of the recent tragedy at 
the school. With an institution that's so steeped in technology, particularly one that put 
together one of the first massive Macintosh based compute clusters, it's easy for us to iliink 
of the technology first. MacTech even had an issue featuring die Virginia Tech Cluster on its 
cover. However, this is clearly about the people involved, and everyone touched by this 
event. Our hearts and minds are with them. 
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Broke your Mac or iPod, but don't 
feel comfortable diving in without 
any experience? What Apple doesn't 
tell you is that you can fix your Apple 
laptop or IPod yourself. All you need 
PS the part, the right tools, and a way 
Into your Apple product. That's where 
we come in. 


Our goal is to empower people to do 
repairs themselves by giving them the 
knowlege, tools, and parts to do so. So 
far, we've helped over 20,000 people 
repair their computers and iPods. We'd 
be happy to help you, too. Check us 
out online or give us a call at 1-866- 
61 -FIXIT (34948). 


You fix It.We make it easy. 

We enable you to repair your Apple 
Power Book, iBook, M a eBook or iPod 
yourself. 

With thousands of Mac + IPod parts, we 
can supply you the exact Apple part that 
you need. We sell the tools that repair 
techs use and provide free Fixit Guides 
so you can take it apart yourself Go 
ahead and take a look. Each Fixlt Guide 
has detailed disassembly instructions 
that walk you through the process of 
accessing and replacing components 
in your machine. The Fixit Guides are 
available for free on our website. 


We sell parts for Mac laptops and 
iPods, We have great deals on: 

- AC Adapters 

* Batteries 

* Case Components 

* DC St Sound Cards 

- Displays 

* Fans 

* Hard Drives 

* Keyboards 
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* Processors 
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* Wir eless Cards 
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Mac + iPod Parts & Upgrades 



Use this coupon for $5 off your next 
purchase at www.iFixit.com 
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AppleScript Essentials 


by Ben Waldie 

Introduction to 
AppleScripting 
Microsoft 
Entourage 


Take note that, when creating a new outgoing message, it 
will not automatically be visible in Entourages interface. 
Regardless, it is created, ‘lo make a newly created outgoing 
message visible in Entourage's interface, the message must be 
opened. Fortunately, the make command will return as its 
result a reference to the newly created message. This reference 
may lx: placed into a variable, which can then be opened using 
the open command, as demonstrated below, 

set theSubjeet to "Some Subject" 

set theBody to "Some Body" 

tell application "Microsoft Entourage" 

set theMessage to make new outgoing message with 
properties [subject:theSubjact. contentrtheBodyl 
open LheHessage 
end tell 


For some time now, wc have been discussing scripting the 
Microsoft Office applications, partially in preparation for the 
forthcoming release of Office 20U8, in which Microsoft has 
announced that Visual Basic macros will no lunger be supported. 
So far. we have explored the AppleScript support in Microsoft 
Word, Excel, and PowerPoint, three applications that currently (in 
Office 2004 ) include Visual Basic macro support This month, we 
are going to discuss die fourth major Office application, 
Entourage, a popular email and project management client. 

Unlike the other Office applications, Entourage does not 
include Visual Basic macro support. So, when Office 2008 is 
released, there won't be any macros requiring conversion. 
However, Entourage does possess fairly comprehensive 
AppleScript support. Using AppleScript, it is possible to 
manipulate various types of elements in Entourage, including 
messages, contacts, events, tasks, notes, and more. In this 
month's column, w f e will explore ways of manipulating some of 
these elements* let’s get started. 

Working with Messages 

Probably the primary elements wilh which you will want 
to interact are messages. Using AppleScript, it is possible to 
create messages, read messages, send messages, move 
messages from one folder to another, and more. 

In Entourage, there are two primary types of messages, 
incoming and outgoing. While each of these types possesses 
its own set of properties, both types inherit a number of 
common properties from the more generic message class. 

Creating an Outgoing Message 

To create a new outgoing message, use the make command, 
followed by the class outgoing message, and optionally, 
properties to be assigned to the message. For example: 

set theSubject to "Some Subject* 

set theBody to "Some Body" 

lell application "Microsoft Entourage" 

make nev outgoing message vrith properties 
fsubject:theSubj ect. content;theBodyI 
end tell 

* *> outgoing message id of application "Microsoft 

Entourage" 


Adding Recipients to a Message 

In tlie examples that we have discussed above, we have 
specified certain properties for the outgoing message, which 
are assigned when the message is created. Specifically, we 
have specified a subject and a body for Lite message. 
However, an outgoing message cannot be sent without first 
assigning it recipients* 

When assigning recipients to a message, each recipient 
must consist of two bits of information, The first bit of 
information is the address, and the second is the type of 
recipient (to, ec, bcc). The address of a recipient is broken 
down even further, into two more parts - an email address and 
a display name G.e. first and last name of the recipient). 

To accommodate this. Entourage's AppleScript support 
includes a recipient class, which possesses an address 
property and a recipient type property. The value of a 
recipient's address property translates to the address 
class in Entourage, which has a display name property 
and an address property of its own. Put together in 
AppleScript code, this all translates to the following for each 
recipient in the list of recipients: 

[address:(display name:"ReciplantName", 

address:"ReelplantEmailAddress"I. recipient type:to 

recipient! 

Now, let's put this together to assign recipients as a 
message is created. The following example code will create an 
outgoing message in Entourage, addressing it to Ben Waldie. 
and copying MacTech Editorial, the result of which is 
shown in figure 1. 

set theSubject to "Some Subject" 

set theBody to "Some Body" 

tell application "Microsoft Entourage" 

set theRecipienta to Uaddress : (display natne:"Ben 
Waldie", address; "ben@a11tf3matedvorkflows.com" I, recipient 
type;to recipientJ, jadd teas:l display name: "MacTech 
Editorial", address: "editoriai@mactech.com"L recipient 
type:££ recipientJI 

set theMessage to make new outgoing message with 
properties {recipient;theRecipients. subject:the$ubject, 
content:theBody1 

open theMessage 
end tell 
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Sending an Outgoing Message 


O O ^ ifcoiSome Subject 

tj S, • ® f J ' fe 


From My Email (Ben Waldte) 
To Sen Waldie 
Cc 0 MaeTech Ediioria! 
Subject: Some Subject 
► Attachments none 

Font Font Size 

Some Body 


Figure l. An Outgoing Message with Recipients 


Adding Attachments to an Outgoing Message 

Another common tusk when creating outgoing messages is 
adding attachments. One or more files may be added to an 
outgoing message as attachments by providing the paths to 
those files when ihe message is created, as follows: 

sei theSubject to "Some Subject" 
set theBody to "Some Body" 

set theAttachment to choose file with prompt "Select a file 

to attach:" without invisibles 

tell application "Microsoft Entourage" 

set: theRecipients to I [address: [display name:*Bon 
Vial die" * address :*ben@a Li Lomau-dworkllows .com" I , recipient 
type: to recipientL Ieddress:(display name:"MacTech 
Editorial". address : "editorial@mactech.roai H 3 , recipient 
typeicc recipientII 

set theMessage to make new outgoing message with 
properties 1rccipient:theReciplentsubject:theSubject r 
content:rheBody, attachments:rbeAtiachment \ 
open theMeesage 
end tell 

In tins case, wc have only added a single attachment to an 
outgoing message. Adding multiple attachments is done in the 
same manner. Just specify a List of paths, rather than a single 
path. Figure 2 shows the result of ihe previous example code. 


r\ n r\ 

AitSame Subject 2 


[■?■ & 

'VUnii * ft # aJ ' «. ‘ ~S 

- 

Frpm: 

My Email (Ben Waitfjci : 1 


Tp: 

Bert Walrtt 


Cc. 

# MacTech Editorial 


Subject. 

Some Subject 


▼ Attachments 

Some nta.doc 



Some f He.tfoc Z4 K 

( 


Encode tar jny tAppieOot&ttl, n p efrtnptffrfJOV! 



font Si«; 



Figure 2. An Outgoing Message with an Attachment 


Once you have created an outgoing message, you will 
must likely want to send it. Earlier, we discussed opening 
outgoing messages, since they are not visible by default. Well, 
if you are going to immediately send an outgoing message after 
creating it, then you might not need to open it. Regardless, to 
send a message, use the send command, followed by a list of 
the messages you want to send. For example: 

send theMessage 

Please note that, when first sending a message via 
AppleScript, Entourage will display a dialog notifying ihe user 
that a script is attempting to send a message (figure 3). The 
user must click a Send button before the script can proceed. 
Keep this in mind, and lx: prepared for this occurrence. 


A script is attempting to send a message. 

Some scripts can contain viruses or otherwise 
be harmful to your computer, so ifs 
important to verify that the script was 
created by a trustworthy source. 

Do you want to send the message? 

Cancel f- Send ; 


Figure 3. Entourage's Send Message Warning Dialog 


Working with Incoming Messages 

So far, we have been discussing ways of working with 
outgoing messages. Incoming messages possess most of the 
same properties that outgoing messages possess, so interacting 
with them is very similar. 

To retrieve a list of currently selected incoming messages, 
reference the selection property of the application. For 
example: 

toll application "Microsoft Entourage" 
selection 
end tell 

-> (incoming message id 136 of application "Microsoft 
Entoutage*I 

Once you have a reference to an incoming message, you 
can retrieve any of its properties. For example, the following 
code will retrieve the subject of a selected incoming message. 

Tell application "Microsoft Emourage" 
set tbeSelectlon to selection 
set theCurrentMessage to item 1 of theSelfiction 
subject of fhoCutrentHessage 
end tell 

--> "RE: Meeting Today!" 

Forwarding a Message 

'lb forward a message to another recipient, you can use 
Entourage’s fonvard command. This command requires a 
reference to a message to be forwarded as its direct parameter, 
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Optional parameters include a to recipient for the forwarded 
message, and whether the forwarded message's window should 
he opened in Entourage's interface. For example: 

tell application "Microsoft Entourage" 
set UieSelection to selection 
set theCur rent Message to item 1 of theSelecUon 
forward LheCurrentMesuage to "ben@autania ted workflows, com" 
with opening window 
end tell 

window *FW: Meeting Today!" of application "Microsoft 
Entourage" 

Take note that the result of the forward command in the 
example code above is a reference to the window of the 
forwarded message. This is because we specified tliat the 
forwarded message should be opened If we had specified lor 
die message not to lx* opened, then an outgoing message 
reference would have been returned instead. For example: 

tell application "Microsoft Entourage" 
set LheSelection to selection 
set theCurrontMessage to item 1 of theSelection 
forward theCurrcntMessage to "ben@autoina Led workflows, com* 
Without opening window 
end tell 

*-> outgoing message id 11277 of application "Microsoft 
Entourage* 

Moving a Message to a Folder 

You may have a need to move incoming messages from 
one folder to another via AppleScript* To do this, you can use 
the move command. When using this command, you must 
provide a reference to tile message you want to move, along 
with a reference to the folder into which you would like the 
message to be moved. For example, the following code would 
move the currently selected message into a folder called “Some 
Folder"* 

tell application "Microsoft Entourage* 
set theSelection to setnetion 
ant theCurrentHessage to item I of tbeSelection 
move tbeCurrentMessage to folder "Some Folder 1 * 
end tell 

Keep in mind that since folders have a hierarchy in 
Entourage, then they must lx* addressed within this hierarchy 
via AppleScript. The following example code would move a 
message into a folder named "Another Folder", which resides 
inside of a folder named “Some Folder”, 

tell application "Microsoft Entourage" 
set tbeSelection to selection 
set theCur rent Message to item i of theSelectioii 
move theCurreutMessage to folder "Another Folder" of 
folder "Some Folder" 
end tell 

Working with Contacts 

Now that we have discussed ways of interacting with 
messages in Entourage, let’s discuss ways of Interacting with 
other «cripiable elements. First, we will lake a look at contacts* 
To create a new contact in Entourage, use the make 
command, much in the same way that we discussed creating 

M/CIKH 


outgoing messages. For the sake of efficiency, you will 
probably want to apply properties to the contact as it is created. 
To do this, use the make command's optional with 
properties parameter. 

The following example axle demonstrates how this is 
done. This particular code will create a contact, complete with 
a first name, last name, company, job iiile, business address, 
business web page address, and email address. Figure 4 shows 
an example of the newly created contact* 

telJ application "Microsoft Entourage" 

make now contact with properties I first name:"Ben*, last 
name: "Vfildle", company; "Automated Workflows, LLC". job 
title:"President*, business phone number : "610 925 065?", 
business address;(street address:"116 Cold Stream Hoad", 
city:"Phoenixviile", state:"PA"* zip:"19460*, 
country: "USA" \ * business web 
page: "http: //wwv*automatedworkflows ,eoin" , email 
address:([label:"Work". 
contenLs:*ben$automatedworkflows,com"1 f1 
end tell 

--> contact id IB of application "Microsoft Entourage* 

St* Wild*# * Cont*tfl 

V fft ~ * 

r fcimWM-y Hone wart flenom Q*k- CcUfiefe 

-Ben Waldie 

xtwwd 1hAM«d. LLC 

>J*'L1«G64 SHAl* iSW 

0 hHO jrwntm Cflrrtr 

ei0'*iv as« 

H-nuM 


_ Ull h*vrr Ld? n*u4K KOt* 


Figure 4* A Newly Created Contact 

Please note that, in the example code alxjve, AppleScript 
records were used to assign values to certain contact properties. 
This is because these properties reference classes tliat contain 
properties of their own* For example, the business 
address property of a contact references a value of class 
postal address. The postal address class possesses 
street address, city, state, zip, and country 
properties. 

Working with Events 

AppleScript may also he used to interact with calendar 
events in Entourage* Like outgoing messages and contacts, 
events may be created using Lite make command. For example, 
the following code will create a new event for tills year’s 
Worldwide Developer’s Conference in San Francisco. Figure 5 
shows an example of the newly created event. 

set theSL an Date to date "Monday, June It, 2007 12 : 00:00 AM" 
set theEndDate to date "Friday, June 15 . 2007 11 : 59:00 PM" 
tell application "Microsoft Entourage" 

make new event with properties (subject:"WWDC"* 
location;"Moscone West. San Francisco, CA*. content;"Apple 1 s 
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Worldwide Developer's Conference**, start tine:theStartDate, 
end time:theEndDate) 
end tell 

*~> event id ^0 of application "Microsoft Entourage" 

A ■TV O W IWWIX; * CilerKfar [Or\ My torrtpUTej'J 

^IlNlll 1 *jt: ^ ii Dwkifli * ji EjUipOftti - ' ' PtDjtiLU * 

s^totc: fwncl 

lK4i-Ort MtHJflrtt WtlL |JH t rVWJMLt. C* 

iwn MK'jtatii.'zMr . itmvt ** ±> r 

Entf (•> Mi I! .-Kf LL S3 Hi D^J!>*n >|WI mnvuwi : ■ 

Dttw'i U3!tD'.fi t 



ffei-lftn* Pswtemjr'* (MtltlfW* 


Figure 5. A Newly Created Event 


In Conclusion 

Like the other Microsoft Office applications, Entourage 
has fairly comprehensive AppleScript support, and we have 
really only scratched the surface in this month s column. 
You are encouraged to explore some of the other things that 


can be done via scripting, such as interacting with tasks, 
triggering AppleScripts from Entourage rules, and more. Be 
sure to view Entourage’s AppleScript dictionary for a 
complete list of its AppleScript terminology. 

Another great way to get started with scripting Entourage 
is to download some of the many freeware and shareware 
AppleScripts for Entourage that have been written by third- 
party developers, such as Paul Berkowitz. Many of these scripts 
are available from the Script Builders section of MacScriptennet 
http ;//scriptbuilder$,net/ 

Note to Readers 

Many of you who are regular MacTech readers know Lhai 
l have been writing monthly AppleScript columns for MacTech 
for several years now. In addition to writing for MacTech, I've 
also l>een busy running Automated Workflows, LLC, my 
AppleScript and workflow automation consulting firm. As my 
company has grown, so have my commitments. Eor this 
reason, 1 have decided that it is time to begin focusing more on 
my company. Therefore, this month's column will serve as my 
final regular MacTech column. 

Throughout the years, 1 have received numerous emails 
from you, the readers. I want to thank you for your many 
nice comments and questions along the way. As always, 
my email inbox will remain open, and you arc welcome to 
continue sending your comments and questions to me in the 
future at ben@automatedworkFlows.com. 1 will also be 
attending WWDC 2007, and I hope to have the opportunity 
to meet some of you there, as well. 

Eor a complete list of my MacTech columns, please be 
sure to visit the "Archives" section of the MacTech website. 
You can also find links to all of my MacTech columns, as 
well as many of my other AppleScript and Automator 
articles, tips, techniques, and books on my website at 
http://www.automated workflows.com. 

Keep scripting! * T ^ j 
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Learn F-Script in 20 Minutes 

And have fun playing with Core Image 

- 1 -—-——— — ——fe By Philippe Mougin 
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Welcome 

If you are a Cocoa programmer chances are that you've 
heard of F-Script, an open-source scripting layer dedicated to 
Cocoa, If you haven't tried it yet, this is your chance to learn 
how it can improve your productivity as well as those of the 
users of your own Cocoa applications. In this articlearticle, 
our goal will be to produce a nice little animation using fancy 
Core Image effects* In doing so, we will learn the basics of F- 
Script* So install yourself comfortably in front of your 
Mac, download the latest F-Script version from 
htfp://www.fscripLorg and enjoy the trip! 

First Contacts 

We are going to learn F-Script by taking advantage of 
one of its key functionaliiyfunctionalities: the ability to be 
used interactively* With its console, you can interactively type 
commands in order to manipulate Object! ve-C objects on the 
fly* The F-Script console opens automatically when you 
launch F-Script,app* Inside it, you can type F-Script 
expressions or scripts and have them immediately executed 
when you press Return. 

@06 F-Script 

>1 " 


Figure 1* The F-Script console, waiting for your input 

F-Script is a Smalltalk dialect for Cocoa and should look 
very familiar to you. Indeed, Brad Cox t who created objective- 
C describes it as “a hybrid language that contains all of C 
language plus major parts of Smalltalk 1 ** Here is an example of 


a message sending expression, both in Object ive-C and F- 
Scripi, In this example, we ask for the current date using the 
NSDate class provided by Cocoa. 


Objective^ 

F-Script (La, Smalltalk) 

iNSDate date] 

NSDate date 


As you can see, the expression is similar, except for the 
fact that, in F-Script* you don’t have to put brackets around 
your message. This is because 1'-Script is a very simple 
language and sending a message is nearly the only thing 
you can do. Therefore, there is no need n> have a special 
syntax to delimit messages* Now, if you type this expression 
in the console anti hit Return, it will be immediately 
evaluated and the result will be displayed (obviously, the 
result you’ll get will differ from the one shown below): 

> NSDare dare 

2007’OV 16 17:01:4b +0100 

F-Script provides numerous tools to assist you during such 
interactive Cocoa sessions, in this first sessionsession, you are 
likely to find the following tips useful: 

* Fhe console keeps a history of your commands. You can 
navigate it using the up and down arrows of your 
keyboard. For instance, if you mistype something and F- 
Scripf signals an error, you can use this feature to get 
back at your command without having to retype it, 

* You can insert a line break by pressing the Enter key 
(usually found on the numeric keypad) or by pressing 
Return white holding the Control key* 

* The console also provides a code completion mechanism that 
you can use by pressing the F5 key* You can then navigate 
between arguments placeholders with Control-Slash, 

* A graphical object browser opens automatically at startup. It 
is a very powerful tool with which you can explore objects 
and send them messages. 
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Before continuing to talk about the language itself, let me 
give you a little hit of the history: Smalltalk was created in the 
early seventies at the famous Xerox Palo Alto Research Center, the 
PARC, by a team led by Alan Kay. As you might know, since then, 
Smalltalk has been having a big influence on the software 
industry . For instance, you might have heard about a visit that 
Steve Jobs made at the PARC in 1979* A visit that had a 
considerable influence on the design of the Lisa and the 
Macintosh computers, What Steve Jobs was shown there was 
Smalltalk. It Itad a graphical interface, was the first object-oriented 
system, and supported networking* "You guys are sitting on a 
gold mine here. Why aren't you making this a product?" asked the 
young Steve Jobs* A short time later, several people from the 
PARC were working at Apple and the rest is history,,. 

So, what is the basic concept of Smalltalk? The key insight 
leading to the design of Smalltalk is that we can describe 
everything in terms of objects* As Alan Kay puts it "Smalltalk's 
design is due to the insight that everything we can describe can 
be represented by the recursive composition of a single kind of 
behavioral building block that hides its combination of state 
and process inside itself and can be dealt with only through the 
exchange of messages", indeed, in Smalltalk, everything is an 
object, even mim!>e renumbers, or booIeansBooleans* 

It is also important to note that F-Script provides an 
interactive environment with which you ran directly interact 
with your objects, instead of having to develop a specific 
application each time you want to do something* 


F-Script’s Syntax 

In a F-Script program the main control structure is message 
sending. In F-Script, as well as in Objective-C, a message with 
no argument is called a "unary message 11 . A message with one 
or more colons in its selector Is called a "keyword message". 
And, unlike Objective-C, there is a third kind of message in F- 
Script: a message that is composed of non-alphabetical 
characters like +, etc., is called a "binary message". A binary 
message always has only one argument. 


Message type 

Objective-C 

F-Script 

Unary 

[NSDate da Lei 

NSDate date 

Keyword 

[NSDate 

da teWi i hTiroe Interv¬ 
al SineeNov:10] 

NSDate 

dateWithTimalnterv 
alSinceNov:10 

Binary 

Not available 

date! ( d a te2 


The Objective-C equivalent to da tel < date2 would be 
[datel compare:date2 ] = NSQrderedDescending. 

As in Objective-C, messages can be chained together. 
Expressions are evaluated from left to right, giving us the same 
semantics, as shown below. 
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Objective^ 

F-Script 

[[NSDate dale] 
timelntervalSinceNowJ 

NSDate date 
time IntervalSinceNow 


Bui sometimes, we need a way to determine the order of 
evaluation of messages. F-Script introduces a precedence rule 
(the only precedence rule in the language): unary messages are 
evaluated firsi, then binary messages, and then keyword 
messages, 11 you want to change the order of evaluation, you 
can use parenthesis to delimit a message. 

The following example shows a few other differences 
between F-ScripL and Objective-C: 


Objective-C 

F-Scripf 

NSDate 'datel * 

[NSDate date!; 

datel ;■ NSDsle date. 


As you see, there is no type declaration in F-Seri pi. 
Everything is an object and variable need not be explicitly 
typed. The assignment syntax uses := instead of just = in 
Objective-C, and the instruction separator is not the 
semicolon, but the period symbol, like in English sentences. 
The following table shows other differences. As you can see, 
strings are enclosed in single quotes* and comments are 
enclosed in double quotes. 


Objective-C 

F-Scrlpt 

@"A string* 

’a string’ 

I* A comment */ 

W A comment 11 

?selector(datetfithTimeTnterv 
alSinceNovi) 

/MateWithTimelntervalSinceNo 

w: 

[NSMutableArray 
arrayWittiObjects:@"Hi", 
§ n mom™» nil] 

I’fTi’, ’rnornM 

NSMakePoint(200, BO) 

20OQB0 


Displaying a picture on screen 

We now know enough of E-Script to begin with our Core 
Image program. We will first create an NSURL object referring 
to the image we want to display. In this exampleexampie, we 
will use an image that is stored on disk in the desktop picture 
folder You can type the code below in the E-Script console to 
have it executed immediately, 

imageLeeation := NSURL fileURLtfithPath:7Library/Desktop 
Pictures/Nature/Clown Fish,jpg'♦ 

The imageLocatiem variable now points to our NSURL 
object. We will now create a Cl Image object, initialized with our 
image on-disk, 

image ClImage IrnageW1 thCon tenUGf URL :imageLocation, 
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Note that we are using standard methods provided by 
the Mac OS X frameworks. Now that we have an image 
object, we can ask it to draw r itself on screen, again using a 
standard method* 

image drawtnRect: (200O80 extent:3000200) f romRect:image 
extent operation:NSCotnpositeSourceOver fraction:!. 

After executing this code* we should see a beautiful little image 
displayed in the console, as show n below, 

. F-Scr|pl ... ’ 

> iBfiflflLcicatiert > KSUHI f 'A itrflB'y/EwKtfip P l=tur*l/Hoturft/C, Fiih, Jpg; h . 

> iBPSn Cl [ipogv i«i]fl*«itJiC{jntiHit.jO^UPL:lipofl!!Loccition. 

> isoft til ‘M iff-fee 1 ,: (IDD-^JfiE 1 eit*rrt. rfflftoMG) f rcwReet; Image f.ttonl 
^rationiRSCoitHiltsSotffcePvw fraction.jl. 


Figure 2. Loading and displaying an image 
using Core Image and F-Script 


The first argument passed to the drawing method is die 
rectangle we want to draw in* which is denoted with 
200O80 extent: 3000200. This expression actually 
creates an NSValue object representing a rectangle with an 
origin at (200, 80) t a width of 300 and a height of 200, When 
passed to the method, the NSValue is automatically mapped 
by F-Script to an NSRect structure. This kind of automatic- 
mapping between objects and primitives Qhjective-C types 
makes it possible to use die Mac OS X Objet:Uve-C based 
frameworks from a pure object language such as F-Script, 
You can change the rectangle size to make the image bigger 
or smaller and immediately see the result on-screen. 

The drawing method draws the image in the current graphic 
context, which, in our example, happens to be the F-Script 
console* It is possible, of course, to draw elsewhere, using 
standard Mac OS X techniques. 

Using core image filters 

Cote Image filters allow us to do all kind of highly optimized 
image processing. Mac OS X comes bundled with dozens of 
filters. Going forward with our exploration, wc will apply a 
filter known as Cl Bum pDistortion, which creates a bump in the 
linage. You are encouraged to try other filters as well. F-Script s 
interactivity makes it fun and efficient to explore such Mac OS 
X capabilities. The following F-Script code creates a 
ClBumpDistortion filter object and configures it to process our 
image, creating a bump of radius to 800 and of scale 2. 
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filter ClFilier filterWithName; 'CTBuDipUistortiou'. 
filter setValue:image forKey: 1 inputImage', 
filter setValue;(CIVector vectorWiihX:1000 Y;700) 
forKey: 1 inputCenter 1 . 

filter setValne: 900 forKey s 1 inputRadius' 4 
filler setValue:! forKcy: 1 inputScale 1 . 


Now that the filter is configured, it will apply itself lo our image 
when asked to provides its output creating a new image and 
giving it irack to us: 

bumped image filter valueForKey: ‘output Image 1 . 


Wt can now draw this new image on screen: 

bumpcdliuage drawInRect: (200080 extent:3000200) 
froaRect:image extent operalionrNSCompositeSourceOver 
r taction:!. 



Figure 3. Our image after processing 
by a Core Image "bump" filter 


To understand how the filter works, it is interesting to change 
its configuration (for instance, the values of its radius and its 
scale) and to regenerate and redisplay the image. If you are 
.sitting behind an F-Scripi console, you are encouraged to do so! 

Using blocks to create 
an animation 

Now that we know how to process and display an image, 
we can create a nice little animation by repeatedly processing 
the image with a varying filler and displaying the result. To do 
that we just need to learn how write a kxjp using P-Scripe 
But, wait a minute... Isn’t F-Script supposed to have a 
very simple syntax, where everything is expressed by sending 
messages to objects? Well this is exact and, in fact, F-Script 
does not have any special syntax for control structures such as 
loops or conditionals. So the question here is "How can we 
express useful programs without such syntax?* To answer Lhai t 
let me introduce you to the concept of code blocks in F-Script. 
Below, we see a code bloc k in Object! ve-C and one in F-Script. 
Note the use of brackets in F-Scripr, instead of curly braces. 
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Objective^ 

F-Script 

1 

instructIonI: 
instruction2; 

1 

l 

instruction!, 
instruction^, 

! 


The code blocks look similar, buL the way they work is 
quite different, in Ghjective-C, when the computer executes 
the code block, it simply executes the instructions in it 
immediately. In F-Script, the code block is actually a kind of 
literal notation for an object that contains the instructions. In 
other words, a block represents a deferred sequence of 
actions. In F-Script, the presence of a code block does nor 
lead to the execution of its content, but to the creation of a 
block object, that can then be asked to execute the 
instructions. To do that, we send the "value" message to the 
block. The result returned by the execution of a block is the 
result of the evaluation of its last instruction. 

As you can see below, F-Script blocks can have local 
variables, just like in Objective-G If the instructions in the 
block refer to a variable that is not declared as local, F-Script 
will look for it in the enclosing lexical context of the block, 
as is the case in Objective-C. 


Object! ve-C 

F-Script 

1 

id local1, locali; 

instruction!; 
instruction^: 

1 

1 |local! loeal?.| 

instructioni, 
instrucLion2, 

1 


The main point to understand here is that F-Seript blocks are 
objects. Like with any object, you can send messages to a block, 
you can assign a block to a variable, store a block in a collection, 
pass a block as an argument to a method, archive a block on-disk* 
and so on. Blocks are not unique to F-Scnpi (or Smalltalk). They 
are present in numerous languages (sometimes under the name 
of "closure" or lambda expressions 1 ") such as Ruby, Python, Lisp, 
GroovyGroovy, and the forthcoming O 3- 

Now that we have blocks, it is easy to do conditional 
evaluation. Boolean objects provide a method named 
if True; which takes a block as argument. If the value of the 
Btx)!enn is true, then the bloc k is executed by the method. 


Objecfiv©*C 

F-Scflpt 

if (a > b) | 

( 

Inntructions 

I 

[a > b) ifTtue: 

t 

Instructions 
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Boolean objects also have a method named 
if True: if False: that lets you have something equivalent to 
ihe if/else control structure of Objective-C. This method takes 
two blocks as arguments. One that gets executed if the 
booleanBtxilean is true and the other one that gets executed if 
the boolean Boolean is false. 


Objective-C 

F-Script 

if (a > b) 

t 

instructions 

\ 

else 

l 

instructions 

I 

{a > b) IfTrue: 

t 

instructions 

] 

ifFalse: 

l 

instruct!ons 

] 


For performing our animation, we need a way to 
repeatedly evaluate a block. Let's review how F-Script 
provides this. 

Blocks provide a method named whileTrue:, which takes 
another block as argument. The receiver of the whileTrue; 
message evaluates itself, and, if the result of this evaluation is a 
booleanBoolean with a value of true, the argument gets 
evaluated. This process is repeated as long as the receiver 
evaluates to true.+ 

Note that in the example with conditionals, die if True: 
message was sent to a booleanBoolean object. In the latest 


example, the whileTrue: message is sent to a block Lhat 
returns a booleanBoolean. This is very different. Indeed, it 
would not make sense to implement a whileTrue: method in 
the booleanBoolean class. This is because the value of a 
particular lxx>leanBoolean never changes; whereas the value 
returned by the evaluation of a block can change from one 
evaluation to another. 

Now f that we know how to express repetitive evaluation, 
we can finally write our animation: 

keyWindow := NSApplication sharedApplication keyWindow. 
rect := (200O10Q extent: 3Q0O20Q). 

1 0. 

[i < 2500] vhileTrue: 

E 

filter setValue;(ClVector vectorWithX:I Y:700) 
forKey: 1 inputCenter', 

bumped Image :® filter valueForKey;’outputImage 1 . 
bumpedimage drawInRect:rect fromRect:image extent 
operation :N5CanipositeSoiirce0ver fraction;1. 
keyWindov flushW.1 iidov. 
i i + 5, 

1 

As you can see, we move the bump across the image, 
by varying the X component of the Cl Vector object that 
define the center of the bump. We use a control variable 
named T that we increment by five at each iteration of our 
loop until it becomes equal to 2500. We also ask the 
window to flush Itself at each step of our iteration in order 
to display the new image and produce rhe animation effect. 
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Blocks with arguments 

For such kind of iteration, however, a tor loop is more 
appropriate, and you might wonder if F-Soipi provides it. 
Well, it does! But in order to master it we must learn another 
feature of blocks: support for arguments. Block arguments are 
declared at the beginning of the block. just after ihe opening 
bracket. Each argument name is specified after a colon and a 
vertical bar ends the argument list. A block must then be 
executed using an appropriate "value../ message. For 
example, here is a block with no argument. We evaluate it by 
sending it the value message. 

['hello world’] value retUITlS ’hello world' 

Below is a block with one argument. In this case, we send 
a value: message, specifying the argument that will he passed 
to i he block, 

(:a| a class] value: 1 a string 1 rCtlimS String 

Here is a block with two arguments. To evaluate it, we 
send it a value: value: message, 

[;a :b | a + b] value: 2 value:! rotUTRS 


Now that we have blocks with arguments, we on make 
use of powerful methods. For example, numbers have a 
method named to:do: which lakes an number and a block as 
arguments. The block is evaluated for each integer between the 
receiver and the first argument (both included). 


Objective-C 

F-Script 

for (int i=0: i <** 100: 

14+) 

t 

instructions using i 

\ 

0 to:100 do: 

U 1 | 

instructions using i 

i 


F-ScripL also provides a to:by:do: method that let us 
specify an iteration step. 


Objective-C 

F-Scripl 

for (int i=0: i <= 100: i 
" i + 5) 

1 

instructions using i 

» 

0 to:100 by;5 do: 

i*i| 

^ instructions using i 1 


We can make use of it in our animation script which then 
becomes: 

keyWindow MSApplication sharedApplication keyWindov. 

rect :» (2000100 extent:300 0 200), 

0 to: 2500 by:5 do: 

I:i| 

filter setValue:(ClVector vectorWithX:i Y;700) 
forKey:‘inputCentnr*. 

bunpedTraage :* filter valueForKey: ’output. Imugu’ . 
bumped Image drawlnRect:rect frosRect: image extent 
opera 11 on: NSComposit eSourceOver f ra ct ion: l. 
keyWindo¥ t'lushWindov. 

You can change the value of the step to .see how it makes 
the animation faster or slower 

Conclusion 

Now that you are familiar with F-Script, you can use it 
whenever you want to explore a new Objective-C API, 
interactively prototype code or debug an application. And since 
you can easily embed it into your own application, you can 
provide your users with an interactive and scripting layer for 
your application's functionalities, by just exposing them as 
Objecttve-C objects. . 

/ill 
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Mac in the Shell 


By Edward Marczak 


The man Show 

Learning shell utilities 
with and without man 

_ J 

Introduction 

Documentation. The ugly reality is that it s usually an 
afterthought for a project, if completed at all. We like to code, 
we like ro connect systems, but rarely do we like to document 
the work, man (“manual") pages, the built-in documentation 
system, have thousands of entries for shell utilities. Depending 
on the author, these entries range from well-written, humorous 
anti pleasurable reading, down to sparse, lerse and frustrating. 
Sometimes, the simple act of giving usage examples would 
make ail the difference in usefulness and clarity. While l can t 
cover every shell utility here, 1 would like to point out some 
that you should know about, but that may not have the best 
documentation or just lack examples. 

networksetup 

Just as the name implies, networksetup is a utility to 
configure the network interfaces on a Mat' OS X machine. 
There’s no man page for this one at all. By default, it’s 
not even in your path. Currently, tinder OS 10.4 (“Tiger"), 
you’ll find networksetup located at: 
/Systein/Li bra ry/Core Se rvtces/RemoteMa nagement/ ARD Age 
m.app/Contents/Support/nelworkseiup (whew!). There is, 
though, a usage statement printed if you run the command 
but lists no options and provides no examples. 

Since OS X uses configd to inform the system of its 
current configuration state, the old-school utilities, such as 
ifeonfig don’t really work too well. Oh. yes, they can read 
ihe current state of die network, but setting it is another matter. 
This will work for a little bit, at least until configd receives a 
change event and reconfigures things for you. 

networksetup uses terminology that is closer to the 
OS X OLJI than traditional devices, too. first thing you 
typically need to figure out are the names of the network 
services being offered - a.k.a. the interface names: 


networksetup Uistallnetworkservices 
An asterisk (*) denotes that a network service Is disabled. 
Bluetooth 
Built-in Ethernet; 

Built-In FireWire 
Airport 

Parallels Host-Guest 
Parallels NAT 
VPN (L2TF) 


(You do, by the way, need admin level privileges to run 
this utility). You’ll note that these names correspond to the 
names in the Network System Pane: 


v Network Status 

Bluetooth 
Built-in Ethernet 
Built-in FireWire 
AirPort 

Parallels Host-Guest 
Parallels NAT 
VPN (L2TP) 

Network Port Configurations 

Figure 1 - Interface names 

If you rename the interface in the Network Pane, 
networksetup will see il that way, too. A possibly more useful 
list, if you're on a machine that you’re not familiar with yet, is 
gained from the -listnetworkservice order switc h. El shows both 
the interface name and the order that OS X uses it: 

# networksetup -listnetworkservEeeurdet 

An asterisk (*} denotes that a network service is disabled. 

(1) Bluetooth 

(Hardware Port: Bluetooth, Device: Bluetooth-Modem) 

(2) Built-In Ethernet 

(Hardware Port: Built in Ethernet. Device: enO) 

(3) Built in FireWire 

(Hardware Port: Built-in FireWire, Device: fvO) 

(4) AirPort 

(Hardware Port: Airport. Device: enl) 

£5) Parallels Host Guest 

(Hardware Port; Parallels Host Guest, Device: en2) 

(6) Parallels NAT 

(Hardware Port: Parallels NAT. Device: en3) 

(7) VPN (L2TP) 

{Hardware Port: Windows L2TP, Device: ) 


Tliis list is a great reminder that routes may lx* overridden by 
the order of interfaces. 

Weil, how about setting up the device? There are switches 
that act like each of the settings in the GUT: 
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Manually 

Using DHCP with manual address 
✓ Using DHCP 
Using BootP 

Off 

Figure 2 - How d'ya like your interface? 


Probably of most interest is “-setmanual". To configure lire 
built-in Ethernet interface to have an IPv4 address of 
192.168.50.77, with a subnet mask of 255.255.255.0 and a 
default gateway of 192.168.50.1, you’d use this: 

networksetup -setjnunusl “Bail t- in Ethernet" 192.168. *50,77 
255 *255.255.0 192.163.50.1 

One nice trick chat doesn’t seem apparent from the usage help, 
but has worked for me Cup through 10A9), Is that the router is 
optional. This is critically important when you're configuring an 
interface that will be active along with another 

The second option in our list is 
setmanualwithdheprouter". This is just like “-setmanual", 
without luring able u> specify the subnet of router: 

netvforksetup -setmanual "Built'in Ethernet*' 192.163,50,77 


Setting an interface to use DHCP is simple: 
networksetup -setdhep “AirFort" 

You can also supply a client id after the interface name, if 
necessary. You can also clear the current client id bv using 
“Empty 11 as the client ID name. 

Similar to “-setdhep” is “-setbootp*. The command is the 
same as “-setdhep", however, hootp doesn’t support a client id, 
so, nor does litis command. 

Finally, “-setnetworkserviceenabled” roughly corresponds 
to “Off". This can turn the service “off' or tl on”: 

netvorksetup -setnetvorkaerviceenabied "Bluetooth'' off 

If you run this while the Network Pane is open in the GUI, the 
Gill will alert you with, "Your network .settings have been 
changed by another application” - just something to be aware 
of. It then places an asterisk next to the name of the interface 
when using “distal I networkservices" and 

11st n et workse rv iceorde r". 

Finally, there are some very useful Aiqxm specific 
commands. Different than enabling or disabling tire interface, 
you can also turn power to the Airport off completely: 

networksetup aetairportpower off 
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Of course, you can turn it back on with the same switch and a 
parameter of "on". You can also check the current state with " 
get airport power”. 

Of greater use, though, is die ability to programmatically 
set which network to connect to, using “-setairportnetwork”: 

mnworksetup -setairportnetwork “fligHeL* Sekurel?a$Swd 

Here too, you can find out the current state with a 'get 1 variant: 

nt'l wotksetup getairportnetwork 
Current AirPort Network: SuperAirNet 

The networks etup command is very powerful and very 
thorough! In addition to the options I covered here, you can do 
anything that you can do in the GUI: create VLANs, mm 
AppleTalk on or off, set proxy configuration and more. It’s a 
good command to lx: familiar with for scripting, remote setup 
and just to do things the “OS X wav!" 

sep 

“sep 1 is the secure copy program. It's part of the ssh suite, 
which means that any remote machine you can connect to via 
ssh, you can also copy programs to and from. While there is a 
man page for this one, it doesn't have example usage. Also, 1 
find that not enough people know about or use it - even those 


who use ssh on a regular basis, sep is simple, really. To copy 
a local hie to a remote machine, use this: 

ficp local_file 

rve r,example. com : ! path/to/file/fllename 

You'll he asked for a password from the remote machine. 
Then, given permission on the remote, you'll see a progress 
meter that shows the file in Lransit. In my example* “myjd" is 
Lhe id you use on the remote machine. (For those of you that 
may want to date yourself, unlike ssh, sep does not accept the 
M* (ell) switch to pass in your credentials - a .switch that ssh 
supplies to make the transition from telnet easier!). 

The colon character (V) separates the hostname from the 
path. This can lx; a relative path, too. The starting location is 
the remote id's home directory. Also, like ssh, if unspecified, 
your current id is supplied, ho t if I wanted to copy a file to my 
home directory on my lest box, I could simplify the command 
down to this: 

ftep Ioca1_filtt lycaeum.radiotope,com: 

Do note the trailing colon character. Without it, you'll just make 
a local copy of the file - in this case, named 
“tycaeu m. nadiotoj ae.ee inf. 

To copy from a remote machine, just reverse the order of 
the files, pulling remote information first. To copy “filename" 
from the remote to your machine as u local_file w , try this: 
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scp nsy_id@r emote T examp 1 e * com: / pat h/to/f i 1 e / filename 
local .file 

Again, to use the same name as the remote, simply omit u on 
the ItJeal side: 

scp lycaeuiH. tadlotope* com: program 4.7.6.tar.gz . / 

If you're thinking of using tills in an unattended script, you’ll need 
to autlienticate via Jtejsso that you’re not prompted fora password. 
While there are plenty of examples on the web of how to do this, 
for the sake of completeness, here is the short version: 

Open up a shell on ihc local computer, and log into the 
correct local account. 

Gax:rale a public-private keyp;iir by typing “ssh-keygen - 
i rsa". Leave the pass phrase empty. This creates the files 
“fcLrsa 1 * and “kLrsa.pub* in the .ssh directory in this account’s 
home directory* 

Copy only id_rsa.pub to the remote machine using scp. 
Login to the remote machine, and add the contents of 
kl_rsa*pub to “/jisli/authorized_keys. You can use redirection 
to do this, as the authori?.ed_keys file may already exist: cat 
id_rsa,pub » V.ssh/authurizedjteys 

logout of the remote machine, and lest the setup using 
ssh. Try to ssh back into the remote machine. This time, you 
should nor he prompted for a password. 

Using keys in this manner, you'll he able to setup scp copies in 
an unattended script. 

ssh and File Copy Programs 

You may use ssh every day* You may use some of its more 
advanced features. But it is impossible to Know ssh. For every 
feature that you use, there seems to he another dial you didn’t 
know even existed* Did you know that ssh accepts inpul on 
standard in (stdin) and will simply shove it through the tunnel, 
popping it out on the other side? 

What does that mean to us? Well, you can just gather up 
your data and pipe it to ssh: 

tar czf - /path/to/file | ssh 

Of course, we need Lo do something with it once it gels to the 
other side. Mow about expanding ir somewhere? Let’s imagine 
that we wanted to tar up the kx:al /www directory and get it to 
a remote machine with its hierarchy intact: 

tar czf - /www | ssh *cd /; tar xssfvp * 

Now, tar is a very nice solution - most of the time. It’s 
had a bit of an on-again ofl-again brokenness to it under OS X 
regarding resource fork copying* As 1 write this article, using 
OS X 10.4.9 Intel, tar works very nicely for copying resource 
forks. One other huge advantage to tar is that it preserves 
dates on copy. But, in fact, ditto will do this too, along with 
preserving all of the other OS X-spedftc data that it normally 
does. A simple example is a webloc file, which typically is 
resource-fork only (text clippings are also resource fork only)* 
Fire up Safari, load a page and then drag the icon from the 
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location bar to your desktop. Now you have a resource fork 
only file to work with: 

$ cd Desktop 

$ Iff •1 Weather\ Map.webloc 

rw r r 1 marczak marczak 0 Apr 15 00:33 Weather 
Map.weblac 

$ Is I Weather\ Map.vebloc/..nainedfork/rsrc 

1 raarczak marcuak B 37 Apr 15 08:33 Weather 
M&p,vfcbloc/ -. namedfork/rsrc 

let's move this file to a remote machine using ditto. 
Again, Fm going to copy to my test server (Jycaeum) and 
rely on the fact that by default, ssh plops me into my home 
directory. If you want to write the data elsewhere, replace 
the V" path with one that suits you (and you have 
permission for). Here it is: 

ditto -c Weather\ Map.webloc - | ssh 

lycaeum.radiotope.com ditto -x - J 

Log into the remote server and check out the date, time 
and other file attributes - they'll all stay intact (however, not 
ACLs, as expected). 

Machine Info 

111 leave you with two commands that can display 
informal ion about rhe software and hardware on a given 


machine: sw_vers and syslem_profiler Not that these are 
complex or need a lot of explanation, but just to know that 
they exist. If I could count all of the times 1 see a question 
about getting system information on a tech mailing list, 1 
probably wouldn't be writing this! 

sw_vers is the simpler of the two. With no options, it 
dumps out the product name, version and the build number: 

$ sw_vers 

ProductName: Mac OS X Server 

ProductVereion: 10.4.9 
BulldVersion: BP 135 

You can pass in switches to limit the amount of information 
returned: 

$ sv_vers buiidVersiof] 

8P135 

Filtering the information is certainly useful if you need this 
information in a script, 

system prof iler is the shell equivalent of the GUI 
System Profilerapp. Like sw_vers, just used on its own, it 
gives you a good deal of info. Try’ it! (There's way too much 
output to print here). You can parse through this data on 
your own. If you're only looking for a specific hit of info, 
you can pass in fillers that do just this: 

$ ayslenuprofiler SPMemOtyCiataType 
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Memory: 

BANK 0/D1KM0; 

Size: 2 G£ 

Type: DDR2 SDRAM 
Speed: 667 MHz 
Status: OK 

BANK 1/DTMH1: 

Size: 1 GB 
Type: DM2 SDRAM 
Speed: 667 Mr, 
Status: OK 


You can get a list of data types with the Mistdatatypes" 
switch, if you want more than one type at once, go ahead and 
pass in those types: 

aystem^profiler SPMaplaysDataType SPAirPort Datatype 
SPPowerDataTypo 

sw_vei5 and system_profiIer are both great commands 
when accessing a remote machine that you may not lx; familiar 
with - especially when someone is sitting at the console and 
you don’t want to ask them for the information! 

Summary 

I regularly use the commands and techniques presented 
here, While the information is typically in the man page, useful 
examples don’t always accompany that information. Sometimes, 
you just need to experiment with a command - on a test system, 
of course - until you have it figured out Sometimes there are 
alternatives to man. Many GNU utilities have an info page that’s 
different than the man page, if one even exists. Try 41 info 
emacs 11 , for example. Press 'q' to get out of info’s display. Of 
course, Mac lech and publications like it (are there any?) present 
good alternatives to man pages as well. I hope this article was a 
gotxl step In that direction for anyone reading it. 

Media of the month: well, it’s not going to lie a Leopard 
title, as weYe going to see a little delay there! However, there's 
plenty to be read before then* Don’t get all stressed out about 
it. Instead, find some entertaining reading, like the “Lord of the 
Rings’' trilogy. OK, not necessarily short reading, but I ni always 
surprised by how many people have not read these lxx>ks. The 
movies were fine, but the books capture something different. 

Until next month, enjoy! 

Vi 11 
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Perl 6 On XCode 

Bringing the power of Perl 6 
to the XCode environment 


Introduction 

First developed in 1987 by Larry Wall et al, Peri has 
evolved into the scripting language of choice for 
developing software solutions such as CGI, system 
administration scripts, and database management tools. It is 
also one of the first scripting languages designed to be 
platform-agnostic. Furthermore* ii comes with a very 
extensive library of functions and subroutines, which can 
also be extended or improved. 

This article introduces the next major revision of the Perl 
language, version 6. It will provide a concise overview of the 
language, especially in areas where it improves upon its 
predecessor* Perl 5. It also introduces two open-source projects, 
Pugs and Parrot, both of which will become the basis of the 
new Perl 6 runtime system. It will then demonstrate how to use 
the XCode IDF. to pon these projects to OS X T as well as how 
to add support for Perl 6 to the IDE. A copy of this 
project can be obtained at the following URL: 
<ftp,madech,com/sre/ moctech/volume23_2007/23,05.sit>. 

Enter Perl 6 

A Brief Background History 

Perl 6 started out in 2001 as a series of 8 documents known 
as the Apocalypses These documents address the current 
shortcomings of the Perl language, as well as the proposed 
changes and additions to improve it. Each Apocalypse 
document is numbered to correspond to a specific chapter from 
the official Peri book, Programming in Peri , also fondly 
referred to as “The Camel Book". 

A second set of 6 documents, collectively known as the 
Exegeses, provides a more detailed description of the changes 
proposed in the Apocalypses, They also provide a number of 
code examples to Illustrate the new r syntax and semantics of the 
Perl 6 language. Later on, a third set of 12 doeumeats, the 
Synopses, contains the official design specifications of the entire 
Perl 6 environment. For a more detailed look at these 
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documents, visit the official Perl 6 home page at 
chttp:// dev. perl. org/perl6>. 

The fact that the development of Perl 6 started with 
design specifications is unique in the history of die 
language. Earlier versions of Peri were developed without 
the benefit of a single specifications document In fact, each 
time discrepancies were found between the official user's 
documentation and sources, it is often die former that gels 
updated. Compare this with other modern languages such as 
FORTRAN or C, whose compilers and interpreters are 
expected to comply with their respective standards. 

The Perl 6 Advantage 

Perl 6 is essentially a complete overhaul of the entire PeH 
language. When completed, it will bring a large number of long- 
awaited features and improvements to the Per) development 
community. Some of the more notable ones are as follows: 

* support for static data types 

* formalized and consistent parameter lists 

* strict stgil invariance 

* more robust object oriented design 

* improved regex support 

* simplified and streamlined grammatical syntax 

* support for preprocessor macros 

* an actual switch statement 

Explaining each Perl 6 feature in great detail is beyond the 
scope of this article. Furthermore, the specification is still a 
work-in-progress. Those who are interested in learning more 
about the language, as well as how to start w f riling Perl 6 
scripts, should consult the book, Perl 6 Essentials, which is 
listed at the end of this article, 

A note to all Perl users: The Perl 6 specification is not 
designed to lx* backward compatible to previous versions of 
Perl. However, ii does support the creation of a compatibility 
layer that will allow the execution of Perl 5.x scripts. The only 
limitation is that these scripts will be unable to avail themselves 
of the new language features. 
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The Perl 6 Projects 

Two open-source projects are currently being 
developed to implement the Perl 6 specification. The first 
project, the Perl 6 User's Golfing System (Pugs) f attempts 
to implement the Perl 6 language specification as defined in 
the Synopses. Its end products are two command-line tools: 
pugs, an interpreter with an interactive shell, and pugscc, 
a Perl 6 compiler. The latter tool is capable of compiling an 
existing Perl 6 script into Perl 5, JavaScript, or PIR (more on 
this later) for execution. 

At the Lime of this article, the latest stable version of Pugs 
is 6,4.11. Thu source tarball for this project, together with 
instructions on how to compile it, can be downloaded at 
<http://www.pugscode.org>. 

Unlike most open-source projects, however, Pugs is written in 
Haskell, which is a pure functional programming language with 
non-stria semantics. Since GCC does not have built-in support 
for 1 laskull, the Glasgow Haskell Compiler (GJ1C) needs to be 
installed into OS X in order to compile the Pugs sources. An OS 
X installer for the latest version of GHC (6.4,1), which also fixes 
a compatibility bug with GCC 4.0, ran be downloaded at 
<http://haskelLorg/ghc/download_ghc_641 .html#maco$x>. 
Furthermore, the hs-plugins library needs to lx? installed 
with GHC. This library enables GHC to compile, load, anti 
evaluate Haskell sources at runtime. The OS X installer for this 
library is available at http://darcs.net/DarcsWiki/ -* 

Category Binories#headc 14449f675f 1 F36c707G353 8d40e7 
9f056a69bd9 

The second open-source project is Parrot, This project 
attempts to create a register-based software CPU that is 
designed to run a wide range of languages as efficiently as 
possible. It uses a multi-layered design that enables it to 
support both dynamic languages such as Perl or Ruby, as well 
as static ones such as Java. It also uses just-in-time compilation 
to improve its execution speed. Once completed, it will become 
Lite de facto runtime engine for Perl 6, 



Figure 1. The Parrot Runtime Engine. 


Figure 1 shows a simplified diagram of the Parrot engine. 
Here, a parser (usually Pugs) converts a Perl 6 script into an 
intermediate file format known as a PIR, or Parrot 
Intermediate Representation. This PIR file is then compiled 
into assembly code, which is then optimized and translated into 
byte code for exec ution by the virtual machine. 

At the time of thiswriling, the latest stable version of the 
Parrot engine is version 0.4.4. This version contains an 
initial implementation of a Perl 6 compiler, as well as 
compilers for API and Scheme. It adds support for 
hierarchical class names, tree transformations, and 
rules/operators precedence. It also has an improved and 
redesigned grammar engine. 

The latest Parrot source tarball, together with instructions 
on how to compile the project, is available at the Parrot home 
page located at http://www.porrotcode.org/source.html 
Since Parrot requires at least GCC 3 x and Perl 5.6 for 
compilation, it will require version 10.3 or newer of Mac OS 
X. 

Porting Perl 6 with XCode 

The XCode Advantage 

Like all open-source projects, compiling Parrot and Pugs is 
essentially a command-line affair, both projects use the 
venerable makefile system to configure and control Lheir 
respective compilation process. 

However, with a little work, the XCode development 
environment can be used to port these open-source projects 
to OS X. Its user-friendly text editor, together with its well- 
designed search/replace features, can be quite useful in 
navigating the plethora of files and scripts that make up 
these projects. Also, the configuration, compilation, and 
even the installation processes for these projects can be 
controlled to a fine degree through the judicious use of the 
Run Script build phase. 

Parrot in XCode 

The XCode project for Parrot (Figure 2) is created using 
the Empty Project template from the New Project Assistant 
dialog, its project directory contains all Lire files and 
subdirectories obtained from the Parrot source tarball. The 
project is assigned with three build configurations: Debug, 
Release, and Install. The first two are standard 
configurations provided by the project template, while the 
last one is used by XCode to install the resulting binaries 
and support files directly into the host OS X system after a 
successful compile and lest run. 

The Parrot project has two unguis: Parrot Make, which is the 
default target, and Parrot Clean. The Parrot Clean target is an 
external target. Its sole function is to reset the entire project to an 
uncompiled state when the Clean option is chosen from the Build 
menu. The Parrot Make target, on the other hand, is a shell script 
target. It contains four Run Script phases, each phase controlling an 
aspect of the Parrot build process. 


42 May • 2007 


WWW.MACTECH.COM 


























now scneauiing 
and contact 
management 

for your entire 
organization. 


Now | Up to Date and Contact 5 

Calendar and Contact Software for Business, Groups, Families and You. 



New 

SOFTWARE 


866-527-0556 
www, nowsof twarexom 


Is this project on schedule? When are you available to meet about the systems 
upgrade? Where are all the Field techs today? When was the lost time anyone talked 
to our biggest customer? 

Virtually all groups live [or die) by their abilities to meet deadlines and keep track of 
their customers, prospects, and vendors* Few small companies or even departments 
of big companies have the tools they need. 

Now Up-to-Date & Contact might just be the calendar and contact software for you. 
It's time-tested and used by more Mac-based companies than any other solution. And 
it's cross-platform-avoilable for your PC users, too. It’s easy to install and manage and 
simple for your employees to understand and use. 

Using Now Up-to-Dote & Contact you can schedule meetings for multiple users, view 
multiple, simultaneous calendars, and reserve rooms and resources* You can share 
contact information about your customers, prospects and vendors. And using our free 
server software you can set it up in minutes and share with users in the office or from 
anywhere with an internet connection. 


Call us now at 866-527-0556 or email us at mactech@now$oftwarexom 
and well send you our free evaluation kit, including the book that will 
make it all easy, 'Take Control of Now Upto-Date & Contact" from 
Take Control books! 


Copyright O 2006 by Now SoTiwur#, Inc. All righfi reserved Now Up to Dote and Now Compel cm wgislarad trademarks of Now Software, he Mac curd the Mot logo are Prodomorb of Apple Computer, Inc., 
registemd in the U .5. and attar countries. All other Prodemorb acknawlerJrjfld. 













Parrot sourced, scripts, 
«m<l directories 


Parrot Make 



Parrot Clean 

# 



ParrotCsnfi<j 

Pa r rotC orrtpi 1 e 

Parrot Test 
i'arrot Install 


Figure 2. The Parrot XCode project. 


The PamujConfig phase first checks the current build 
configuration by querying the configuration setting. It then 
executes the Perl script, Configure.pl, while passing the 
desired installation directory using the — prefix option. Once 
the script has finished, it then checks to see if any errors 
occurred during configuration, and if at least four of the 
principal files were generated 


The second phase, Parrot_Conipilt\ starts the compilation 
process by invoking the make tod. The tool then uses the 
Makefile generated during the configuration phase. Again, 
the phase checks tor any errors generated during the process. 
The next phase, ParroLTest, runs a series of standardized 
tests to see if the newly built Parrot engine is working correctly. 
These test scripts are bundled with the Parrot sources and 
should not be altered to ensure reliable results. 

This phase first queries the P ARRGTJTE STMGDE 
setting to determine the type of lest that needs to be run. If 
the setting is set to 1, the test process is started by invoking 
the make tool with a test option, A setting of 2, on the 
other hand, will invoke the tool with a full test option. 
Any other setting will cause this phase to skip the test 
process entirely. 

The fourth and final phase, Parrotjnstall, controls the 
installation of Parrot binaries and support files. Available 
only to the Release anti Install configurations, it sLarts the 
installation process by invoking the make tool with an 
install option. The Debug configuration, however, skips 
this phase entirely, and an unknown configuration will 
generate an error signal. 

The destination directory used by the installation 
process is the one set in the Parrot_Config phase through 
the —prefix option. For the Release configuration, the 
process uses the directory specified by lhe build setting, 
IN STALL_PATH By default, this is set to the value of 
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P* : 1fr. itcalepra: 


${B1JILD_DIR) /Library/Beveloper/PerH/par roi 

where build dir is the location of ihe build directory 
vviLh respect to the Parrot - xcodeproj bundle. The 
Install configuration, on the other hand, uses the one 
specified by PARROT _PATH_IN£TALL This setting default to 

$ I LOG A L_DE VELO l 1 ER_D i KI / Perl 6/parrot 

where LOCAL DEVELOPER DIR is tile /Library/Developer 
directory of Lite OS X boot volume. In retrospect, this directory 
proved to lie a more appropriate place to install additional 
developer tools. Most open-source projects usually install their 
end products in either /user/local or /opt/local. 
However, unlike those two directories, L0CAL_DEVEL0PER_DIR 
is a public direaory and, as such, does not require any sudo 
privileges to l>e accessed 

Pugs in XCode 

The second XCode project, Per 16 (Figure 3), is also 
created using the Empty Project template. Its project 
directory contains all the files and subdirectories that came 
with the Pugs tarball file. Furthermore, it contains a 
reference link to the Parrot * xcodeproj bundle. It also 
shares the same three build configurations as the Parrot 
XCode project. 
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Figure 3. The Per! 6 XCode project. 


The PerMS project has four targets. Parrot Only is an 
aggregate target that directly references Parrot Make from 
the Parrot XCode project. Selecting this target will start the 



G& 


Experience the power of greater 
bandwidth and improved 
performance with Smalt Tree 
multi-pod cards and switches. 


SmallT 


ree 


COMMUNICATIONS 

www.small-tree.com • 866.STC.4MAC 


If you’re ready to turn up the flow of your 

NETWORK, WE’VE GOT THE TOOLS TO MAKE IT HAPPEN. 

Wf.’rf. the MAC Networking experts with rock solid 

SOLUTIONS AND TOP QUALITY PRODUCTS. LIKE OUR NEW 

Eixif.-Core® switches that delivers enterprise quality at 
a fraction of the cost. So if you’re ready to crank up 
your network performance, call us. We’re here to help. 


IMPROVE 

YOUR 

WORKFLOW 













FLASH AOS 

ggS®4 


Protect your privacy and your Mac! 

Stop programs from silently connecting to the Internet. 
Erase your browser history and instant messenger logs. 
Search and filter your email attachments. 

Prevent others from invading your files. 

Permanently shred your private files. 

Block pop-ups and Flash ads. 


i£ 
Mac 


Fight back and safeguard your Mac. 

DOWNLOAD YOUR FREE TRIAL TODAY! 

www.allume.com/mac/cleanup/ 


SOFTWARE 
ALIUME SYSTEMS DIVISION 

WWW.AUUME.COM 


® TM. and 0 2006 All time Systems. Inr, Mat OS X 10.4 'Tiger" or better is required. 
















































build process for thaL project* The target also contains a 
single Run Script phase, ParroL_Mnvi_\ The function of this 
phase is to copy the resulting Parrot binaries and files into 
the Perl 6 build directory if the current build configuration 
is set to Release. Why use a Run Script phase as Oppose to 
a Copy Build phase? The Copy Build phase does not 
provide any means of detecting the current build 
configuration. Only the Run Script phase has this capability 
by checking the CONHGURATION build setting. 

The second target. Pugs Clean, is an external target that is 
used by the project to reset itself back to an uncompiled state. 
It also invokes the Parrot_Clean target from i he Parrot XCode 
project. Perl 6 is another aggregate target that invokes the two 
targets, Parrot Only and Pugs Only, in their respective order. 
This target is used when building and testing both the Parrot 
engine and the Pugs tools. 

The fourth and final target is Pugs Only. Like Parrot Make, 
this shell script target has four run script phases, The first phase, 
Pugs_Config, starts the configuration process by mnning the Perl 
script, Makefile.pl. It also sets the installation directory for the 
final product by passing the directory path using the PREFIX 
option. It then checks for any configuration errors, and to see if a 
valid Makefile has been created, 

The second phase, PanroCCompile, first checks the build 
setting, PUGS OPTIMISED, to determine how to compile the 
Pugs tool. A selling of 1 will invoke the make Uxil without any 
command options. Any other setting will invoke the same tool 
with an unoptimized option* 


The choice of compilation option directly determines tlx 
runtime performance of the Pugs tools, as well as the length of the 
compilation process* An optimized compilation rakes a 
considerable amount of time to complete, but results in binaries 
that provide fast Perl 6 interpretation and/or compilation, 
Conversely, an unoptimized compilation has a much shorter 
completion time. However, it results in binaries with much slower 
runtime performance. Overall, choosing the appropriate option w ill 
depend largely on how the final product is used or distributed. 

The third phase, Pug.s_.Test, mns a series of standard test 
.scripts to ensure that the resulting Pugs lcx)Ls will perform as 
designed. It starts the rest process by invoking the make tool with 
a test option. Since Pugs requires the Parrot engine in order to 
process Perl 6 scripts, this phase will first check to see if the latter 
is installed at the directory path specified by PARRQTPATH EXE. 
Only then will it proceed with the test process. 

Be aware that the Pugs test process takes a tong time to 
complete. Unless the host system has enough computing 
horsepower to spare, this process should either lx* disabled for 
debugging purposes, or assigned to a separate system for 
execution. To disable the test process, set the build setting, 
PUGS TEST MODE, to 0. 

The fourth and final phase, PugsJnstall, prepares the 
installation process for the current build configuration. As 
with ParrotJnstall, this phase is available only for the 
Release and Install con fig uni do ns* It is skipped in its entirety 
by the Debug configuration* Any other configurations, 
however, will generate an error signal. 
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The Release configuration uses the path specified by (he 
build setting, INSTALL_PATH, to install the resulting Pugs 
tools and support files. This .setting has the default value of 

$ ( BUILD_DIR5 /Library/Developer/Per 16 

The Install configuration, on the other hand, uses the one 
specified by the build setting, PUGSPATHINSTALL, This one 
has the default value of 

$ I LOGAL_DEVELQPER_DIR1/Ferl6 

Integrating Perl 6 with XCode 

The First Perl 6 Script 

Once the Perl 6 binaries and support files are installed into 
the host OS X system using the previous two XCode projects, 
you am start writing your Perl 6 scripts. If you prefer executing 
your scripts through the Terminal prompt, make sure to first 
update the PATH variable hy inserting the entries shown in 
Listing 1 to your .bashjrofiie file. Use your favorite text 
editor to updale this invisible file, and make sure to restart your 
Terminal session in order for the changes to lake effect. 

Listing 1. Updating the .bash^profile file. 

#ctefine the Perlfe tools path 

# 

FiiRL6„ENV-/Li b ra ry/Develops r / Per 16 

#start of PARROT configuration 
PERL6 PARROT=$[PERL6 ENV]/parrot 
export PUGS. RMRED=perl5 

PATH=$ l PERL6_PARR0T I /bin: $ I PERLOAKRUTl /lib : $ I PATH! 

#,.end of PARROT configuration 

tfstart of PUGS configuration 

FATH“$ l PERU_ENV I /uer / bin: $ t PERL 6 ENV )/lib:$l PATH I 
..end of PUGS configuration 

Then write the script (let us call it hello.p6) using a text editor. 
A typical script should liave at least the following entries. 

use v6.0; 

say "Hello there, and welcome to Perl 61" 

Notice that the use keyword is used to indicate that the script 
is to lx: interpreted or compiled as a Perl 6 script. Then type 
pugs hello.p6 at the Terminal prompt to run the Perl 6 
script. If the installation was successful, and all Perl 6 binaries 
and support files are properly compiled. Pugs should print the 
following output to the Terminal window 


tlello there, and welcome to Perl 61 

The Perl 6 Project Template 

However, you can use XCtxle to write and execute your 
Perl 6 scripts without having to start a Terminal session. This 
approach allows you to make use of the excellent features 
provided by XCode, such as search anti replace, and integrated 
source-code management. You can also add a standard project 
template to XCode in order to maintain consistency between 
projects as well as maximize code reuse. 
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Figure 4 shows the contents of a basic Peri 6 project 
template. This template is based on the Empty Project template 
and it contains a single source file named main.pG. It also 
contains a reference to the Perl 6 library files, which should lx.* 
installed in the directory /Library/Per 16. It has a single 
Shell Script Target named PeH6 Compile, which itself has a 
single Run Script phase named Run Perl6. 


Perl6 Project*xcocteproj 


project * pbxpro] 
TemplateInfo*plist 


mair**p6 




/Library/PerL6 


Perlfi Compile 



Run Per16 


tokens. POD, or Plain Old Documentation is markup 
language used for writing documentation for Perl scripts and 
modules. K serves die same purpose as HeaderDoc and JavaDoc 

Following the header comments is I he Perl keyword, use. 
The numerical value after this keyword indicates that the entire 
script itself is a valid Per! 6 script and should be treated as such, 
A value less than 6 (e.g, !5.8.6) will tell Pugs to run the script in 
its Peri 5 compatibility layer. 

Finally, right after that keyword is the first Perl 6 keyword, 
say. This will print out the string argument to stdout and 
append a new line to the output. It works similarly to the 
traditional Perl 5 statement of 

print "Uello there, and welcome to Ferl 6t\n“: 


Listing 2. The main.p6 file. 

If! / Library/Developer/usr/Mn/pu^s 
fl Description of the file, 

* 

''pod 

w headl Project 

«Name_of_t he_pro j eet * 

=head2 Created hy: 

<Name_of the softwar^developer* 

“head2 Created on: 

cDare_when_tho_project_vaE started* 

*head2 Copyright: 

<Copyri&ht Jfear* <Name_of_the_organisation*, All rights 
reserved. 

“cut 


Figure 4, The Perl 6 project template. 


listing 2 shows the basic contents of the main, p6 file. The 
file sums of with a standard header comment written using POD 


$ basic Perl 6 statement 
use vti.0; 

say "Hello there* Hiid welcome to Feri 61": 

Figure 5 shows the project settings used by the Peri 6 
project template, The setting, PERL6 PATH, points to the Perl 
6 directory where Pugs and Parrot are installed. The PATH 
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environmental variable in XCcxle is then updated to include the 
locations of the Pugs and Parrot binaries. Finally, the build 
setting, PERL6 LOGERR0RS, is used to determine whether or 
not to write the Perl 6 execution errors to a log hie. If set to I, 
any error messages generated by the Peri 6 script will be 
written to the log file, per!6_run*err. 
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Figure 5. Settings of the Perl 6 project template. 


The contents of the Run Script phase, Run Peri6, are shown in 
Listing 3. The script first checks to see if Parrot, Pugs, and the Perl 
6 libraries aie correctly installed in the OS X system. It then checks 
the PERL6_LOG__ERRORS to see if an error log should Ire prepared 
Wore executing the Peri 6 script. Finally, it .starts executing the Peri 
6 script by passing the file, mairupS, to the pugs tool 

Listing 3, The Run Script phase. Run I J erl6, 

f Check to see if Perl 6 is installed 

# 

# checking for Parrot 
if f ! -x $ < PERL6_BIN_PARR0Tl /parrot 1; 
then 
echo 

echo "Parrot is not installed on your system." 
exit 1 

elif [ t -x $ I PERU .BIN FUGS |/pugs 1: 
then 

echo 

echo "Pugs is not installed on your system," 
exit 1 

elif [ ! -d $[LIBRARY_£EARCH_PATHS t U 
then 

echo 

echo "The Ferl6 library is not installed on your 
system." 

exit 1 
else 

t execute the Perl 6 script 

t 

if [ $(PERL6„LOG_mORS \ eq I ]; 
then 

| Initialise the error log 

echo "Log started ons" l»porl6_run.err 
date l»perlf]_run.err 

# Run the Perl 6 script 

pugs nairr.p6 l»perl6_run.log 2»perl6_rtin.err 

# Finalise the error log 

echo "Log ended on:" l>>perl6_run.err 
date J>>perlti_mn,err 

# Check the log for errors 
if [ s perlh_run.err J; 
then 

# check the contents of the Log 

I 

ERR CNT= grep -e ° [eE]rror" perl6_run.err | vc - 
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if f sm CUT tie 0 ] ; 
then 

echo "Errors were generated while running the 

Perl 6 fieript." 

exit 1 
fi 
fi 

else 

| Juet run the Perl 6 script 

pugs main.pb 
fi 
fi 

S Successful execution 

echo "The Perl 6 script ran without any problems. M 
exit 0 

To finalize the project template, the -xcodeproj bundle is 
opened using the Finder and two user-specific files containing the 
file extensions,-model and .pbxuser, are deleted. Then a 
Templatelnfo.plist file (Listing 4) is created and added to the 
bundle* This file is used by XCode to identify and preprocess the 
project template each lime it is selected from the New Project 
Assistant (Figure 6). Once the template is finished, it is then copied 
to die appropriate subdirectory within 

/Library/Application Support/Apple/Developer 
Tools/Project Templates/ 

Listing 4. The Templatelnfo.plist file for the 
Perl 6 project template. 
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Figure 6. The project template 
as seen from New Project Assistant 


Concluding Remarks 

Peri 6 is the next major revision of the Perl language. It 
provides a wide variety of new features, as well as long-awaited 
improvements to the language. It is also the first revision to be 
designed around an official language specification. 
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Bringing Perl 6 to OS X is accomplished by using 
XCocle to port the Parrot and Pugs projects to the platform. 
These two open-source projects form the basis of the entire 
Perl 6 system. Adding Perl 6 support Lo XCode is also easily 
accomplished by creating and adding a project template to 
the development environment. This template contains the 
basic placeholder file, build settings, and library references 
that are necessary for developing and running Perl 6 scripts. 
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Apple’s Transition 

from Open Firmware to 
Extensible Firmware Interface 


By Criss Myers 

Preface 

In January 2(X)6 T Apple introduced Intel Architecture 
based Macs* They took this hardware move as an 
opportunity to also upgrade their choice of firmware. Their 
previous firmware, Open Firmware, was not in itself a bad 
choice, being far more advanced than the IBM PC BIOS that 
Windows computers use. There is, however, a better 
firmware choice that offers improvements on Open 
Firmware, called Extensible Firmware interface, EFI P 
developed by Intel* When Apple looked for a successor to 
their PowerPC Processors, they found a complete hardware 
package from Intel. They got the latest CoreDuo and Xeon 
Processors, as well as advancements in boot firmware and 
disk partitioning. Since Apple offers an integrated package, 
this enables them to control all aspects of the computer 
system from processors to boot firmware to operating 
system. This also enabled them to make a smooth transition 
from the PowerPC, Open Firmware, AFM and their 32bit OS, 
to Intel processors, EFI, GPT and 64 bit Tiger OS X. Anyone 
using these 2 systems will not notice any difference apart 
from thdr performance. In this article we will take a brief 
look at Open Firmware and then explain what EFT is, its 
history, and what this means for Apple's future as well as 
that of the PC market in general. 

Open Firmware 

Apple's PowerPC Macs, post-NuBus, used a boot 
firmware called Open Firmware. Open Firmware, also 
called OpenBoot, was developed by Sun Microsystems and 
is used in Sun's Sparc work stations and servers, IBM 
POWER systems and PegasosPPC systems and is available 
under a BSD license. It was described by IEEE as IEEE 1275- 
1994 btn since 1998, it has been withdrawn. In 2006 several 
commercial versions were released to the open source 
community under the OpenBlOS project, these include, 
SUN OpenBOOT, Firmworks OpenFirmware and Codegen 
SmartFirmware. Open Firmware is a hardware independent 
firmware and fulfils the same tasks as BIOS does in a PC. 
The advantage of Open Firmware to Apple is that any I/O 


cards that work, in say SUN machines, could also be used 
in Mac machines without requiring any specific Mac drivers. 
Open Firmware also offered BOOT? capabilities for 
Netbooring machines as well as setting boot devices. On a 
Macintosh, most user settings can be changed via GUI tools 
and the Open Firmware can be locked to prevent booting 
from non-authorized sources. 

Extensible Firmware Interface (EFI) 

History 

EFI was developed by Andrew fish working for Intel 
back in the 199G's and was initially called “Intel Boot 
Initiative (IBI)". It grew up around the need to replace the 
aging PC BIOS developed by IBM in the 1970's, IBI was 
intended for their Itanium Architecture (1A) based computers 
because the existing PC BIOS was tar too limiting for future 
64 bit operating systems, some of these problems being 16 bit 
processor mode and PC AT hardware dependencies to name 
a few. Since then, IBI was developed by Intel into EFI and 
subsequently released by them to the open source 
community in 2005. It is now called lIFF! (Unified Extensible 
Firmware Interface) and is currently at version 2.1. 

Due to the failed performance of these IA machines, EFI 
never took off as a common replacement for the PC BIOS. In 
2006, Apple moved to EFI and was then the only vendor to 
take advantage of this firmware interface. Linux has supported 
EFI since 2000 using “elilo" as a lxx>t loader and both Windows 
and HP-UX support EFI, but all of these only support 1 A -32 and 
IA-64 platforms. Windows Vista is expected to support EFI but 
only in a later service pack and Microsoft's stance is that until 
EFI becomes mainstream they will not support it. 

What is EFI? 

EFI was designed to abstract ihe firmware and hardware 
layers from the operating system layer. This is so that operating 
system vendors and developers no longer need to battle with 
cumbersome l6bit BIOS and constant hardware configurations. 


60 May * 2007 


WWW.MACTECH.COM 







Fig 1. Legacy PC BIOS vs. EFE 


Figure 1 compares EFI and BIOS showing EFT as a standard 
interface between die OS anti the hardware, EFI is a set of 
specifications to define interactions and programmatic: interfaces 
between die hardware and the operating systems, it is then up 
to the specific hardware vendors to make an EFI compliant 
system. Since EFI is just a set of specifications, it is not an actual 
firmware; therefore, it is up to each vendor to create their own 
firmware to initialize their hardware. Intel’s firmware, and hence 
Apple's choice, is called “Intel Platform Innovation Framework 
for EFT, also called "Framework", It is a legacy free firmware 
that complies with EFI. k is nor available to end-users as a 
complete firmware package but parts of the code are released 
under the TianoCore project, (wwwdianocore.org). Apple 
created their own version of "Framework"; we will see later how 
they implemented EFI and framework. 

EFI is very similar to Open Firmware in dial it is a boot 
firmware independent of hardware and operating system. What this 
means is that it allows die operating system to boot and run in a 
“sandbox" mode, A “sandbox” mode is a safe protected mode 
where the operating system does not make direct calls to the 
hardware. EFI controls die hardware; it takes the calls from die 
operating system, and dien passes them on to die hardware, 
creating an interface Ixaween the OS and die physical firmware, in 
much the same way dial a virtual machine works. This then offers 
a stable environment from which ro run die OS. Tire advantage of 
this is that only the firmware controls the hardware (see Fig 2). 



Figure 2 - EFI as an interface between 
the OS and the Firmware. 


For developers this means Lliey will no longer need to 
make HIOS/OS dependant drivers, they can create EFI based 
drivers which will then work in any compatible EFI machine 
irrelevant of the OS or BIOS loaded. Obviously, for Apple this 
means a wider range of I/O cards can lie supported in the 
future once more hardware vendors support F.FL EFI is free of 
any of the memory restrictions that BIOS has and can use all 
available memory. This speeds up boot time as sveil, a Mac Pro 
for instance can bool up and load the OS in just 15 seconds. 

The EFI specification is broken down into “boot services” 
and “runtime .services". Boot Services are any services that run 
during boot only, such as f the loading of drivers and the 
accessing of graphics during boot. The services use “EFI Drivers” 
"EH Applications" and "EFI Boot QxJe". Runtime Services rnn 
while the computer is running accessing such things as date/lime 
etc. EFI Drivers are written in C and conform to the EFI Drivers 
Model. They can lie loaded from any non-volatile memory, either 
in option ROM, or on the device directly. 

Apple’s implementation 
of EFI and Framework 

The EFI Boot Process 

Firstly, the computer powers up, the Framework then, 
via EFI boot services, Initializes the hardware such as the 
Bluetooth, USB, VGA, network IP stack, remote control, etc. 
These boot services will load all the hardware drivers 
necessary to detect any OS that resides on either an internal 
or external hard disk, or a network volume. Apple's 
Framework does not boot into text mode but directly into 
graphics mode, just like ii did with Open Firmware. There Is 
no direct access to the text mode or EFi shell. Apple has 
developed their Framework to work in much the same way 
as Open Firmware did, using the same key strokes: C boots 
to CD/DVD, N boots into the Netboot disk, V boots verbose 
and S boots into Safe Mode, etc. This makes a seamless 
transition from Open Firmware to EFI for the user. 

Following this, various EFI Applications can be loaded; 
one such application is the Boot Manager, The Boot Manager 
is used to select and load the operating system, removing the 
need for a dedicated boot-loader mechanism. On an Apple 
this looks very similar to the Open Firmware boot-loader but 
with updated graphics. Apple has created their own EFI 
compliant Boot Manager with their own graphics. Apple's 
Boot Manager can detect any Mac operating system that is 
available to the system. According to Apple, their EFI 
Application can, however, only read boot-code from a GPT 
formatted drive or an Intel based NetBoot image; only one 
Nelixjot image is displayed and is either set via the “Startup 
Disk" section on the client or is the default image set on the 
server. Initially the Boot Manager could only detect Mac 05, 
but Apple used the “compatibility support module" to 
support legacy FC BIOS such as XP. This will only display a 
single legacy OS per drive. 
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Figure 3 - EFI with the CSM Module. 


Apple's Boot Manager Application will cither bexit from the 
default volume or you can enter the graphical selection screen 
via the option keystroke, just as with Open Firmware, The EFI 
boot axle is then read from the hard disk and the operating 
system is loaded. Control is then transferred to the OS. Some 
higher operating system drivers can now he loaded for various 
devices. The Operating system will then pass calls to the 
firmware, which will pass them to the hardware. 


a Mac. However, this module only recognizes a single legacy 
Os per drive and labels them as Windows only. This is not 
useful in a triple boot system. An open source project was 
then started called rEFIt tools which offers a boot menu to 
detect multiple OS per drive and label them as the appropriate 
OS’s, It also offers a maintenance toolkit with direcl access to 
l he EFI pre-kiot environment and gives access to the EFI Shell 
Application, The current version is 0.8 and can lx* loaded via 
CD, USB or directly off the internal drive. When you boot the 
Mac with the option key held down, you can then select the 
rEFIt tools from their installed location. 

Conclusion - Future Benefits 
of EFI for Apple 

EFI is a complete pre-boot environment, that makes life 
much easier for developers, and since FIT is written in C, it 
is much easier to program for. With more vendors 
supporting this specification it means, for Apple users, that 
more and more devices with be compatible with Macs, This 
can only be a good thing Developers find it a much easier 
environment to develop in due to its pre-boot environment. 
They can lest and develop without the need for a VDU 
because they can output the tests directly to text. The pre¬ 
boot environment can also be used for backup, recovery, 
and diagnostics, updating firmware by accessing the 
Internet without the need for an OS. Both American 
Megatrends Inc (AMI) and Insyde Technology, both 
members of UF.F1, have made Pre-Boot Applications sets. 



Bool from ordered l&t of 
£Ff operating system 
loader fs executed 


Standard firmware 
platform I nit [nidation 




Figure 5 - AMI Pre-Boot Interface. 


There are development tools available that allow users to 
create their own pre-boot applications. 


I EFI binaries 


d Boot managei 
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Figure 4 - EFI Boot Process. 

rEFIt tools 

When Apple released BootCmnp with their Firmware 
update, which added the compatibility support module to 
their firmware, it became possible to load the Linux OS onto 



Figure 6 - Pre-Boot Applications. 
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Susbsnption service now available, running on 
Mac OS X Server. 

Details at: www.netteamserver.com/subscribe 


Connect your people, contacts, relationships, projects, tasks, documents, 
blogs, web content... your knowledge itself ... and magic follows. 


Aost businesses already have this data but in different systems, used by different people, in different 
iepartments. What a nuisance! NetTeam Server brings it all together, in a web app that everyone can 
ise, anywhere. What a difference! 


NetTeam Server 


Features 


MetTeam Server is a business process, content management, collaboration 
and social networking web app for businesses and organizations of any 
size. It offers people, project, task and document management services 
and has a powerful API to support customization. 


the triangle represents NetTeam Server's unique combination of 
functionality for three critical areas: Process, Content and Community. 
We're a good choice even if you only need one of these, but if your 
business operations embrace two or three, you'll love what we can 
do for you. 



- Web Content/Site Management 

- Web Document Library 

• Project and Shared Blogs 

- News Editor 


- Users, roles and relationships 

- Simple CRM 

- Social Networking 

- Profile & Personal Blogs 



NetTeam Server’s fundamental constructs are 
People, Projects. Tasks and Documents. 

These four are central to all business activities, so we 
bring them together in a coherent workspace that 
makes NetTeam Server a true Business Operating 
System, The portal interface can be tailored to match 
client branding and linked systems, and includes five 
Editors (see screenshot) and a modern, AJAX-enhanced, 
configurable user interface. 

User roles determine access privileges and which (If any) 
tools are presented on login. Blogs are used extensively 
to support publishing, information and knowledge 
management. Wikis will be available in a late- 
summer update. 



NetTeam Server fs available for Mac OS X Server, Linux and 
Windows platforms and supports all leading web browsers. 
A Web Services API allows tight integration with other 
systems and singte sign-on. We also offer a Java mobile 
client which can be tailored to support mobile workforce 
applications. 

NetTeam Server has been successful in deployments 
serving from 10 to 10,000 users and may be installed on a 
server of your choosing, used on a dedicated server we 
provide, or rented as a subscription service (multi* 
company server). 

Consultant, reseller and developer enquiries welcome. 


NetTeam • www.net team server com 
2300 M $t NW, Suite 800, Washington DC 20037, USA 
* 1 (202) 250 3434 * info@netteamconsulting.com 
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Register 


Get your .COM 
or any other 
domain name 
here! 

FREE with every domain: 

Starter Web Page 
Getting Started Guide 
Complete Email 
Change of Registration 
Parked Page w/ Domain 
Domain Name Locking 
Status Alert 
Total DNS Control 

Just visit 

wwWamactechdomains.com | 

to register for your domain today! 


when a non-domain name product 
is purchased. Limitations apply. 


This oilers Apple the chance to create their own Pre-Boot 
Applications which can be stored on the System EF1 partition, 
which is currently empty on Apples GIT drives, but is created 
by default with a set size of 2U0mh. Apple could develop pre- 
boot versions of Time Machine for Leopard so that an OS X 
system could he recovered via an existing backup, or use a pre¬ 
boot Disk Utility to repair a drive. Third party companies such 
as Norton or Tech Tcxil could install pre-boot versions of their 
Applications to this hidden partition also. Apple could also 
make a pre-lxx>t version of Front liow so that users can access 
their DVDs, MP3s, AppleTV without needing ro hoot the OS. 
This also offers secure network IxioLing, remote provisioning 
and setup as well as virus scanning etc. For the general user it 
will offer them a stable environment to run the Mac OS X 
without as many kernel panics. 
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Are you ready for ediscovery? MaifTank can help you beat the rap! 


eDiscovery is here to stay. Managing 
business communications is now a lot 
more difficult. If youVe been following the 
news, you know that missing email is a 
red flag for zealous investigators wanting 
to make a case against you. 

No one who's running a business since 
the new regulations kicked in can be 


sure when cyber-sleuths from the 
government - or a private party nursing 
a grievance - may show up at your door 
with a subpoena in hand 

All of us have learned by now that we 
need to be careful with email. Even the 
most innocent exchanges might be taken 
out of context and may be used against 


you. If an eager prosecutor or attorney 
decides to launch a fishing expedition, 
don't be surprised - be prepared. 

If one day you are asked to produce all of 
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Uninstalling with AppleScript 

Building an uninstaller with AppleScript Studio 



Introduction 

In a previous MacTech article, we learned how to use the 
PackageMaker tool to build a distribution package. We also 
learned how ro localize that package for different languages, 
and how to customize it with scripts. But the orte tiling we 
were unable to do wilIi the tool is to build an uninstaller. 

Third-party tools such as ViseX and InstallerMaker can 
add an uninstall option to their installers. This feature is sadly 
missing from PackageMaker, though not without reason. In 
fact, most products are easy to remove - they are contained 
in a single folder, and trashing that folder completely 
uninstalls the product. But some products will have multiple 
files installed in different directories. Others will create custom 
directories to store the files, A good example of such a 
product is Xcode Its installer creates the custom directory 
Developer to contain its files. The installer also stores files 
in other directories such as /System/Library and 
/Library/Application Support. As a result, removing 
Xcode from the system can lx: a laborious process. In these 
situations, an uninstaller tool can be useful. 

This article will demonstrate how to use AppleScript 
Studio to build an uninstaller To get readers started 
on their own uninstallers, the Xcode project Uninstall is made 
available for downloading. A copy of this 

project can be obtained at the following LJRL 

<Ftp,moctechxom/src/modech/volviTie23_2007/23.05.sit>. 

The Receipts Bundle 

After ihe installer installs a software payload, it creates a 
copy of the package in the Receipts directory. The path to this 
directory is /Library/Receipts on the boot volume. 

The copy of the installer package is known as a receipt 
bundle. Its presence indicates that a product has been installed 
successfully. It also tells the installer package if the latter has to 
do an upgrade, as opposed to an installation. 

Figure l shows the internal structure of a typical receipt 
bundle. Notice that the bundle has most of the same files as an 
installer package. What is missing is the ,paz,gz file 


containing the actual payload. Also missing arc the two aliases 
to that file from the Resources subdirectory. 



3 undl£Veir&iCfi£ .plist 
package version 

I nm tal lot i c r.C Seek 
prtfMght 


*.iprog 


Figure 1. Structure of a typical receipts bundle. 

There are software tools that purge the contents of the 
Receipts directory. This is often done to reclaim extra space, 
especially when the product associated with the receipt no 
longer exists. But removing a receipt, without removing the 
product, creates a new problem. Without the right receipt to 
guide it, an installer for a new product version may he unable 
to upgrade the current product correctly. 

The BOM File 

Hie BOM file is a list of all the files that comprise the 
software payload. It also defines the locations of each file on 
die target volume. This file is present in both the installer 
package and receipts bundle. 

Hie BOM file format has its origins in the NeXTStep 
operating system. It is also a binary format and, as a result, is 
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not directly readable. To read its contents, use the command- 
line tool 1 shorn to preprocess the BOM file. 

The Is bom tool 

The Is bom tool takes a BOM file as its input and renders its 
contents into human readable text. It then outputs the text to 
another file, or to stdout by default. The ux)t is a standard 
addition to the BSD subsystem of MucOS X Its counterpart Is the 
mkbom tool, which creates a BOM file for a given directory. 

To use the lsbom toot, simply pass the path to the BOM file 
as its input. For example, to process the BOM file for the 
Samplc.pkg receipt, type lire following statement at the Terminal 
prompt. 

1shorn /Library/Receipts/Sample.pkg/Contents/Arch1ve.bom 

TTie tool will then parse die file and display its contents at 
lightning speed on the Terminal speed To better read the output, 

pipe the results of the lsbom tool to the less tool 

l sbum / Jri b r a r y/Receipt s/S a mpIe.pkg/Cootent B /Are hive,bom | 

less 

less will display the first N lines of text from lsbom. The 
number of lines displayed Ls dictated by the height of the Terminal 
window. To display the next N lines of text, tap on ihe Space ban 
To display the previous N lines of text, tap on the B key while 
holding down the <CTRL> key. 

Another way of handling the lsbom output is to save it to a 
file. To save the output to the file Sample.log, use the I/O 
redirection token 

1 shorn /Library/Receipts/Samp ±e.pkg/Contents/Archive.bom > 
Sample.lo^ 

Notice that, in lx>Lh examples, the BOM file is always Inside 
the Contents sulxliretlory of the receipt bundle. Also, the name 
of tile BOM file is always Archive _ bom. Most receipt bundles 
will follow the same conventions. Though it is possible for a BOM 
file to be located elsewhere in the bundle, this Ls rarely done. 

The lsbom output 

Listing l shows a sample output from the lsbom tool Each 
entry corresponds to a file or directory installed by die package. 
The first three items of the BOM entry are arranged as follows. 

directorypath file modes user_id/group_id. 
Each item is separated from the other by a single tab character 
(0x09). Now, if Lhe entry is for a regukw file, it will have two 

more items as shown below. 

directory_path file^modes usei\J.d/group_Jfl 

mimber_o£_byte$ cire_32 

If it is for a symlxilk link r its last item will be the path to the 
original file or directory. 

directory_paLh jfIlc_iiodf?s user_id/group id 
nuinber„af_byT£!; ^ 

originsl_path 

Finally, if the entry is for a device flic, its last item will be the 
assigned device nuwtx'r 

directory_path file_ 0 iodes user_id/group_id device_number 

Listing 1* Sample output of the lsbom tool 

. 4075 5 501/80 

,/Sample.app 40755 501/80 


./Sample,app/Contents 40755 501/80 

./Sample.app/Contents/Info,piist 300644 501/80 947 
1163649540 

./Sample,spp/Coruents/MacOS 40755 501/80 

,/Sample,app/Ccmtenta/MacOS/Sample 100755 501/80 51956 
3193247409 

♦/Sample,app/Contents/Pkglnfo 100644 501/80 8 /4293728S 

,/Sample.app/Contents/Resources 40/55 501/80 

./Sample.app/Contents/Resuurcca/Appearance.tiff 100644 
501/80 4850 1276692542 

p /Samp1e * app/Content s/Resources/English.l 
proj 40755 501/80 

./Sample.spp/Contents/Resource?/log3ish,Iproj/Credits.rtf 
100644 501/80 3*63 36023J8773 

./Sample.app/Contents/Resources/English.iproj/Errors.strings 
100644 501/80 2978 2815210102 

M£)st BOM file listings consist mostly of directories and 
regular files. Device files and symbolic links are seldom found. 
Also, rhe fiie_modes item is essentially the three fiermission 
flags wriiten in octal fonn. Each of the lower three numbers 
represents the permission for world, group, and owner. The 
upper set of numbers represent the type of item in question. 
They are set Lo 40 for a directory, 100 for a generic file. 

Notice that each directory path item starts with a dot 
(*) character. This character Ls replaced by the 
IFPkgRelocatedPath value set in the Info.plist file. If 
that value Ls not set, the directory path is assumed to be relative 
to the OS X boot volume. 

Also, if the package has installed payloads in other 
directories, die BOM listing wall show these payloads. For 
example, if Sample,pkg lias installed two files in the 
/usr/bin directory, the BOM listing may show these files as 
follows. 

./usr/bin 40/56 D/0 

,/usr/bin/foo 100755 0/0 12606 2275820725 

♦/usr/bin/fubar 100755 0/0 12606 2275820725 

Notice that both user id and group id items are set to 0 
in the above example. This means Lhat die owner of the two files 
and the directory is root, Removing the two files will require 
authentication. Do not, however, remove any directories or 
subdirectories with a rtxrt owner. Doing so may remove important 
files, and render die entire OS X platform unusable. 

The lsbom options 

The lsbom tool also provides a number of output options. 
Use these options to display specific entries from the BOM file 
as follows. 

To display only the directories accessed or created during 

installation, use the -d option. 

lsbom d 

/ Li bra ry/Recel pts/£ample,pk&/Contents/ Archive. bom 

The output listing wall also include bundles such as , app, 
.bundle, and . Iproj. To display only lhe paths of files that 
were installed or updated, use the —f option. 

lsbom *f 

/Library/Receipts/Samp1e.pkg/Cont ent s/Archive.bom 

To display only the paths of each direaory and file, use the —s 
option. 
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I shorn s 

/Library/Race!pT s/Samp1e,pkg/Contents/Archive.bora 

Tile 1 shorn looi also has options other than the ones 
shown alcove* To view a list of options, type the command 
1 shorn -h at the Terminal prompt. Also, to view the tool's 
electronic manual, type info Isbom at the prompt. 

AppleScript and the Shell 

AppleScript is the native scripting language of the MacOS 
platform. First introduced in the 199Gs, it is one of the first few 
languages that work in a GUI environment. It also uses a natural 
language syntax, which makes its scripts easy to read and write. 

Another feature of AppleScript is that ti ran be extended 
using plug-ins. These plug-ins, or scripting additions, allow 
AppleScript to do tasks that are slow or impossible to do using 
the core language. The OS X version of AppleScript comes 
bundled with the plug-in named Standards Additions With 
tills plug-in, an AppleScript script can display simple dialogs 
and perform basic file I/O tasks. The script can also run Unix 
shell scripts using the do shell script function. 

The do shell script function 

The do shell script function is AppleScript’s gateway 
to Lhu BSD subsystem of MacOS X. With this function, an 
AppleScript script can execute command-line tools or shell script 
files. It can also run a single-line shell script using this function. 
The function returns any results from the script as a string. 

The function uses the interpreter set by the SHELL 
environment variable to do its tasks. To find out the current 
interpreter, launch the Script Editor tool, which is located in 
/Applications/AppleScripts. On the script window, ty|X‘ 
do shell script "printenv SHELL" and click on the Run 
button. If rhe current interpreter Ls bash, the function will return 
tile siring value of SHELL=/bin/bash on the Results pane. 

Working with file paths 

When using the do shell .scrip! function to manipulate files, 
it requires the file paths expressed using the POSIX format. In 
short, a forward slash character </> must separate each path 
name. For example, to parse ihe BOM file for Sample.pkg, pass 
the script to the function as follows. 

da shell script “> 

"Inborn 

/Library/Receipt s /Sample.pkg/Contents/Archive,bom* 

Now' if a path name contains any spaces, a reverse slash <\> 
character must precede each space. For example, to parse the 

BOM file far Test Sample.pkg, pass the script as follows. 

do shell script "• 

* Inborn /Library/Receipts/Test\\ 

Sanple.pkg/Contents/Archive.bom* 

Notice fhat nvo reverse slashes precede the space in Test 
Sample.pkg. This is necessary due to a little quirk in 
AppleScript. The first reverse slash tells AppleScript to treat rhe 
second slash is pan of the string. The second slash tells the shell 


interpreter to treat the space as part of the script text. 

AppleScript, however, expresses its file paths using Lite 
MacOS format. Instead of a forward slash, each path name is 
separated by a colon <:> character. Also, each path name 
can contain spaces without the need for any reverse slashes. 
For example, rhe file path to the BOM file for Test 
Sample.pkg is written in MacOS format as follows, 

OS X:Library:Receipts:Test 
Sample,pkg:Contents:Archive.bom 

Converting between file path formats can be quite 
tedious. To address this issue, the Standards Additions plug¬ 
in provides the POSIX file class. To convert the MacOS file 
path to Sample.pkg to the POSIX format, type the 
following statement in the Script Editor window. 

POSIX path of alias “OS X:Library:Receipts:Sample.pkg" 

This wilt return the converted path as 
/Library/Receipts/Sample.pkg. To convert it back 
to a MacOS formal, type the following on the editor 
window. 

POSIX file “/Ltbrary/Receipts/Sample,pkg" 

Both examples have file paths set relative to the Ikxh volume 
Both also assume that the MacOS name of the hoot volume is OS 
X. Now if a file path is set relative to a volume other than lxx>t, 
the conversion will reflect that volume. For example, if the 
MacOS file path b set to Users;Applications;Public:, it 
will be /Volumes/Users/Applications/Public/ in 
POSIX format. 

Authenticating a command 

Some shell commands require authentication in order to 
perform their tasks. They are usually invoked in the 
Terminal window using the sudo command. For example, 
to create the subdirectory too in /usr, type the following 
line at the Terminal prompt. 

sudo tokdir /tisr/foo 

The sudo command first prompts the user for an 
administrative password. When the correct password is 
entered, sudo then executes the mkdir command. 
Otherwise, it aborts after the user fails to enter the right 
password thrice in a row. 

Using the sudo command through the do shell 
script function is both tedious and unnecessary. Instead, 
the function can authenticate the desired command by itself. 
For example, to create the same subdirectory shown above, 
type the following line on the Script Editor window, 

do shell script “mkdir /usr/foo“ with administrator 
privileges 

The function first prompts the user for a password using the 
dialog shown in Figure 2. Again, when the user enters the 
correct username and password, the function then executes 
the mkdir command. Otherwise, it aborts with an error 
message after the user fails to enter the right information 
three times in a row. The same also happens if the user 
clicks on the Cancel button. 
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UreftJitiLr 0tnu 


AuttierttitM* 

Script Eritlm requires that you type your password. 

a k 

Mtft t L 

wtk y 

Name foo 
Password *•* 

► DtUJfi 

(?) { Ckncft : ( OK ) 


Figure 2 . The authentication dialog. 

To use either approach, make sure that you have a user 
account with administrative privileges. To learn how to create 
such an account, consult one of the references listed at the end 
of this article. 

Building with AppleScript Studio 

There are many ways to build an uninstaller. One way is 
to build it as a shell script. One example is Xeode, which comes 
with a Perl script to uninstall its various components. This 
approach is easy to implement and lest. It does, however, 
require the use of the Terminal window. It also provides 
very poor user interaction and feedback, if any. 

Another way is to build the uninstaller as a Cocoa 
application. Cocoa gives the uninstaller a better way of 
interacting with the user It also allows Lite uninstaller to 
perform tasks not possible with a shell command. But this 
approach requires too much resources and time to 
implement, It also has a very high learning curve, 

A more practical way is to build the uninstaller as an 
AppleScript application. This is now easy to do with 
AppleScript Studio. The uninstaller gets a decent interface 
with which to interact with the user. It will he easy to build 
and test due to AppleScript s user-friendly syntax. This is the 
approach used for the Xcode project Uninstall. 

Laying out the user interface 

The Uninstall project has a single main window named 
Uninstall Denro, The window is subdivided into two panels 
by an N S' fab View control Both panels contain a single 
NSTableView control. The first table displays the contents of the 
Receipts directory (Figure 3). The second table displays the 
contents of the BOM file for the selected receipt (Figure 4). 
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Figure 3. The Uninstall window. Receipts panel. 
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Figure 4. The Uninstall window. Files panel 

The entire window layout is that of a basic Assistant, On die 
lower right comer are two pushbuttons, Preu and Nent. The 
Newt button is also set as the default button. 

Both buttons live disabled by default. The Ne«t button is 
enabled when the Receipts table has a selected entry'. llie Preu 
button is enabled when the current panel is Lhe one with the 
Files table. Also, when the Files table has a selected entry, the 
Next button becomes die Uninstall button. 

On the lower left corner of the window is the Cancel 
button. This button is set to respond to the <Esc> key. It also 
sends a perf ormClose: message to the window when clicked. 

Binding the widgets 

The window and some of the controls are then bound to 
specific AppleScript handlers. The bindings are set in the 
AppleScript panel of the ShOUJ Inspector dialog (Figure S). 
To display the dialog, choose Shorn Inspector from the 
Tools menu. Then select AppleScript from the drop-down 
list at the top of the dialog. 
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Figure 5. The Show Inspector dialog, AppleScript panel. 

'liable l is a list of the bindings set for each interface widget. 
The handlers shown in this table are all defined in the source file 
Uninstall.apple script. Nc sttce tl lul st m \c w idgets a re boil nd 
to the same handlers. To identify which widget called the handler, 
check its name property, for instance, the following code fragment 
shows how to determine which I Kitten was clicked 

on clicked theObject 
local tBtn 

set tBtn to the {narai of theObject) as string 

if (tBtn is equal to “prev 1 ') then 

" the Previous button has been clicked 

else if (tBtn is equal to "next") then 

the Next button has been clicked 

end if — (tBtn is equal to "prev”) 
end clicked -theObjed 


Wldgel 

Name 

Class 

AppleScript Soilings 

Nam© 

Event 

Handler 

Uninstall 

Demo 

NSWindow 

demo 

Nib 

awake from 
nib 

Pcev 

NS Button 

prev 

Action 

clicked 

Next 

NSButton 

next 

Action 

clicked 

Receipts 

NSTableViev 

rept 

Nib 

awake from 
nib 

Data View 

selection 

changed 

Lists 

NSTabieVim* 

list 

Nib 

awake from 
nib 

Data View 

selection 

changed 


Not shown in the table are the bindings for the application 
itself To bind the application, select the File’s Owner icon 
on the MamMenu.nib window. Then, from the Show 
Inspector dialog, dick on the Application checkbox. Then 
set rhe bindings as shown in Figure 6. 

O f> File's Owrw tospector 

ApoleScdOf : 1 ? 

: Jpfll tadt* 0 

tvem Handlers 

* g Apn^cation a 

^ jifiv4tcd * I 

— ***** n 

^ Hunched 
_ open 

_ open unfit led 

W' 

reigned 4* *ive 
__ should open 
Q_ should qu*i 

should Qldt list Wj m CQ4* c osed 

£j shown * t 

__ was hidden « 

Script 

flies apples* net 
Receipts rtppicvcnp* 

'* UmnstaU.apptescrtpe 


New fdil Scope Qo6*l t 1 

Figure 6. Binding the AppleScript application. 


Binding the Cancel button 

On the other hand, the Cancel button is not bound to 
any AppleScript handler. Instead, it is bound directly to an 
action handler. 

To set the binding, control-drag a line from the button to 
the main window. This will display the Show Inspector dialog 
with the Connections panel view active. Click on the 
Targei/Action tab on the dialog. Then choose performClose: 
from the list of window actions (Figure 7). 


Table 1. AppleScript settings for the Uninstall UJ widgets. 


72 May • 2007 


WWW.MACTEQH.COM 
























feSfrutton injpttt^ 


O O 


Co«rs«f*om 


: ? 


Long Distance 


OfCkflUKTk 

Gtctti 


Act .cm s m kSMftnaow {Untfittjrtl Oernor 

0C ft'.r iJIlpI He 

tec 

«ikHe>Afl(10»d^t nwit 


Otttteti T*r$cf fArt io« 



<M!*e*Ow* 



pr rlq* rW ur h/e 

pcflofrrZeofn 

pfMK 

#*nT0G«ll*fOj’ltQ<H ia*jprtP&:ct*«e 
tow* t oef lut S^cmn 




Ccwi^e<i 


Figure 7. Selecting the performClose: action. 

The Quit Uninstall menu item is also bound in the same 
way. But this will be left as an exercise to Lite readers. 



Building with Xcodc 


The Xcodc project Uninstall contains three AppleScript 
source files. The UninstalLapplescript file has all the handlers 
called by the 111 widgets. The Receipts.applescript file has the 
code to access the Receipts directory'. Finally, the 
Files .applescript file has the code for processing the BOM file. 
It also has the code that will do the uninstall task. 

For reasons of length, this article will only show code that Ls 
relevant and interesting. Readers can always view the entire source 
Files by downloading the project from the MacTech website. 

Accessing the Receipts directory 

Shown in Listing 3 is the fundion handler that retrieves the 
contents of the Receipts directory. It takes a path to the 
directory as its input argument. It returns the results of the 
retrieval as a list of records. 

First, the handler calls the list folder function to read the 
directory contents. 'Hie function responds by returning the 
contents as a list of filenames. Next, the handler parses each 
filename in the list. If the name belongs to a receipt bundle, the 
handler retrieves its bundle signature. Otherwise, the handler 
proceeds to the next name. 

The handler uses the bundle signature to create a record 
together with the name. When done, it appends the record to 
the return list tPkg. 
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Listing 3- Retrieving a list of receipt 
bundles (Receipts. applescript). 

property pRcptftee ; Ihnom:"". bsig;""l 

to getBundles from aPath 
local tLsc, tPkgs 
local tltem , tNotn 
local isPkg 

— read the contents of the directory 

set tlet to (list: folder aPath) 

— parse the list results 

set t.Pkgs to N 
copy pRcptRfir to tRec 

repeat with tKosi In tLst 

— prepare a path to a list item 

set tltent tO aPath & ": rt & tNotn 
get info for file tit.era 

— is the item a bundle? 

set icPkg to package folder Of result 

if tisPkg) then 

** retrieve the bundle signature 

set tSig to ■getBundleSignat ure for tltea) 

— update the record template 

Set nnom of i Ree to LNom 
set bsip, Of iRec to i:Stg 

-- add the updated record to the list 
copy tRec to the end of i Pkga 
end if - (M$) 
end repeat - with tNm in lUl 

— return the retrieval results 

return [tPkgs] 
end get Bundles -pmuPath 

Reading the BOM file 

Listing 5 shows the function handler used To conven the 
BOM file, it also shows how to use the do shell script 
function to call the Isbom tool. The handler takes a path to the 
receipt bundle its its input argument. If successful, it returns the file 
path to a temp file; otherwise, it returns an empty siring 

Firsi, the handler gets a path to tlte Temporary I terns 
directory. It converts tlie path to a POStX formant, and appends tlte 
name of the temp file bom.out. This file will store the output 
results of the Ishont tool. 

Tlie handler then prepares the sc ript to be executed with the 
do shell scr ipt function. Tlte script consists of the file path to 
die BOM file, as well as the path to bom, out, Tor example, if the 

target receipt is Sample.pkg. ihe script will read as follows. 

isbo® -p fa 

/Library/Rec ei pts/Samp i e. pkg/Cotitents /Archive. ham -* 

> -'/Library/TenporaryFiles/bom.out 

Note that, in actual practice, the entire script will consists only 
of a single line. It will also state the full path to the bom,out 
file on the user home directory. 

Notice as well that a -p f s option is passed to the lslx>m 
tool This option tells the tool to display only the file paths and 
sizes of each BOM item. If the item happens to be a directory, 
its entry in the bom, out Ole will not have any size data. 


Listing 5. Generating a BOM file for a 
given receipt (Files,applescript), 

property pBOMPath : "/Contents/Archive.bom" 
property pBOHIerap ; "boa.out" 
property pCmd : "isbom ** 
property pOpts : " p fs * 

to getBQM f or aRcpt 
local tTmp. tCmd 

— retrieve a path to a temp directory 

set tTmp to path to temporary liens from user domain 
set tTmp to POSIX path of tTmp 

— prepare the output file path 

set tTmp to tTmp & "/* b pBOMTemp 

— prepare the shell command 

set tCmd to pCmd b pOpts 

set tCmd to tCmd & aRcpt & pBOMPath 

set tCmd to tCmd Si " > " & tTmp 

— execute the shell command 

do shell script tCmd 

— was it successful? 

try 

set tTmp to (POSIX file tTmp) as string 
alias tTnp 
return (tTmp) 

on error tErr number iTyp 

display dialog (*[FATAL]" & rEri as string) 
return (*"•) 
end try 

end getBOH -for aRcpt 

Listing 7 shows the function handler used to parse the 
contents of the bom-out file. It takes the path to that file as its 
input argument. When done, it returns u list of records, each 
record representing a BOM entry, 

1'he handler first opens a read-only access to the bom-out 
Ole, It reads ail the entries in the file, and then doses the access. 

Tlie entries consist of a list of strings. Each entry alternates 
between the file path and size of a BOM item. Tlie handler creates 
a BOM record for each entry. It then appends the record to tlie 
list variable tBOM. which is returned to the calling handler. 

Listing 7, Reading tlie BOM file 

(Files -applescript), 

property pBOMRec : Ifttoa:"*, fsiz:""] 

property pLF : 10 
property pHT : 9 

to loadBOMItems from theFile 
local tSrc, tSiz, tPos, tLen 
local tLst, tBOM, tDat, rRec, rlMom 
local tTkn, tOdd 

— initialize the following locals 
set tBOM to fi 

set tTkn to {} 

set tTkn to tTkn & (ASCII character pLF) 
set tTkn to tTkn & (ASCII character pHT) 

try 

™ start a read-only access to the file 
open For access theFile without write permission 
set tSrc to result 
if (tSrc > 0) then 

— read the contents of tlie file 
read tSrc using delimiter tTkn 
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set tut to result 

— dose the read-only access to the file 
dose access tSrc 

end if - ffSrt >0J 

— parse the BOM entries 
copy pBOMRec to tRec 

set tLen to the length of list 

if (tLen > 0) then 

repeat with tPos from l to then by 2 

— retrieve the following BOM items 
set tNom to item tPos of tLst 

set tSiz to item (tPos + 1) of tLst 
if (tSiz is equal to '") then 
set tSiz to *-1“ 
end if — (tSiz is equal to N ") 

— prepare the BOM record 
set mom of tRec to (tNom as string) 
set fsiz of tRec to (tSiz as string) 

— append the record to the return list 
copy tRec to the end of tBOM 

end repeat - with tPosfmm 7 to iLcw fy 2 

— remove the first two items 
set tLen to length of tBOM 

set tBOM to items 3 thru tLen of tBOM 

end if >0J 
on error tErr 

- - something wrong has happened 
display dialog ("[FATAL] loadBOMItems:" & tErr as string) 

end try 

— return a list of BOM entries 
return (tBOM) 
end loadBOMItems - theFik 


Removing a BOM item 

There are a many ways to remove a software product. 'Ihe 
direct way is to locale the topmost directory horn the BOM, and 
delete it together with its contents. Another way is to select 
specific items from the BOM for deletion. Choosing the right 
approach depends on the aim of the uninstaller. The Uninstall 
project, for instance, uses a variant of the second approach. 

Shown in Listing 9 Ls the Function handler that will remove 
a BOM item, it is called after the user selected an item from the 
Files lisilxjx, and clicked on the Uninstall button. 

The handler first creates an Uninstall folder in the 
Temporaryltems directory. Next, it moves the BOM item 
from its original path to the folder. It also deletes the item at 
the specified path. Once the handier completes its task, it 
returns a true to the calling handler Otherwise, it returns a 
false if any errors occurred, 

listing 9- Removing a BOM item 
(Files. applescript). 

property pDlrTrash : "Uninstall " 

to removeThelteni given path'aTgu folder:aOtr 

local tlmp. tBin. tCtnd 

-- initialize the following locals 

set tlmp to path to temporary items from user domain 
as string 

set tBin to i:Tmp h pDIrTrash 
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“ create the temporary uninstall directory 

tell application "Finder" 

try' 

if not ■;exists alias tBin) then 

make new folder at folder tTmp ** 

with properti es I name:"Uninstall"} 
end if -- (exists alias tBin) 
on error tErr 

display dialog 

"[FATAL] Failed to create the Uninstall 

directory" 

return false 
end try 

end tell - appliattkm "rindcr" 

— attempt to remove the item 

tell application "Finder" 

tty 

- is the item a directory or a file? 

if UBirO then - rf is a directory 

- test delete the directory 

wove folder aTgt to folder tBin with 

replacing 

delate folder aTgt 
else - it is a file 

— test delete the file 

move file aTgt to folder tBin with 

replacing 

delete file aTgt 
end if -faDir) 
on error tErr 

display dialog *• [ERROR] * in tErr 
return false 
end try 

end tell — applicatioit "fmiJar* 

“ the removal was successful 

return (true) 

end < emo veTheTtem - given palkiTgl, lypcsTyy 
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Notice that the handler uses the Finder to delete the BOM 
item. While this works in most ruses, it will fail if the item is 
inside a restricted directory such us /usr. For that case, replace 

the delete code with the following script statements, 
set aTgt to the POSIX path of alias aTgt 
set tCmd to "cm -Rf * & aTgt 

do shell script tC&d With administrator privileges 


The above statements will prompt the user to validate the 
deletion that is about to occur. 

Also, notice that the handler first makes a copy of the BOM 
item it is about to delete. This gives the user a chance to restore 
the deleted item buck to its former location. 


Final Thoughts 

Produtt removal is just as important as product installation. 
Though most products are easy to remove manually, some 
require the use of an uninstaller tool Tine tod will peruse the 
receipt package for the product, and delete all the files that belong 
to that product. This will help ensure that future products 
installations will lx? more successful. 

AppleScript Studio makes it quite easy to build an 
uninstaller tool. It has a much lower learning curve compared 
to Cocoa. This alone makes for a faster build and deployment 
cycle. It allows the addition of a user-friendly interface, which 
is not possible through shell scripts. 

Hopefully, this article helps to get you started in writing your 
own uninstaller. Until Apple adds an uninstall option to the 
installer imi, writing your own is T for now, the next best solution. 
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by Michael R. Harvey 

AMCC 3ware 
Sidecar Kit 

When it's time to step up 
to more and better 

V_ 


cables, make sure the RAID unit is powered on before the 
computer, and then start up. To configure the Sidecar, you type 
into a web browser: https://localhost:H88. From that web-based 
interface, after logging in as an administrator, you can select 
drives and choose the RAID level you warn, We suggest either 
a 3 disk RAID 5 with a hot spare (you can designate a drive as 
a spare in the web management software), or a RAID 10. Both 
these configurations require all four drive bays l>e used, but 
they give you either very' good performance and fault tolerance 
(RAID 10) or high capacity with hot fail over in case of a drive 
problem, along with a performance boost (RAID 5). After the 
3ware interface has your unit set up, voul! need to partition ii 
using Disk Utility, You are gtxxl to go after that. 

w-i jkHU.A 
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Recently, we reviewed a small NAS unit that was good for 
smaller home offices or work groups. That product, however, 
lacked features critical to any group larger than a few people or 
workstations. Ihe AMCC 3ware Sidecar is the next step up. It is 
a fuii hardware RAID storage device, but not so I rig as to he 
cost prohibitive for smaller installations. This desktop RAID unit 
is an ideal starting point as your storage needs grow' beyond a 
single disk, and a CD backup. 
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Figure 1: The AMCC Sware Sidecar Kit 


The unit itself is a four bay SATA enclosure. It attaches to 
any G5 or newer Mac w r ith FC1 Express, via a multilane SATA 11 
cable to an AMCC 9590E-4MF controller card that is included in 
the kit. The card itself is 4 lanes, and so will work in either a 
4x or 8x PCI Express slot. There also is a controller cable that 
runs between the RAID unit and the card providing device 
management and information to die set up and monitoring 
software, Ihe unit can be placed anywhere with good airflow'. 
It is small enough to fit on top of a G5/Mar Pro tower. 

The software itself is two parts. First, a background process 
that runs at boot and does the monitoring, and, second, a web 
based interface for con figuration and reporting. The system 
requirements are OS X 10.4.6 (10.4.8 for Intel based Mac Pros), 
and Java 1.5 or later. The installer is dreadfully slow% but it’s 
Java based, so that behavior is expected. The web interface, 
however, is responsive, and includes a good help system. 

Hardware and software installation are pretty 
straightforward Put the parrs where they belong, link up the 
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Figure 2: The web control interface, 
displaying an error condition 

The one obvious failing of this unit compared to the NAS 
we reviewed earlier is availability over the network. Two 
options here: In smaller settings, you can use Hornware's 
SharePoints to enable sharing using OS X. Your other option is 
to attach the unit to an Xserve, or othe Mac running OS X 
Server, and share it out lhal way. IPs not an XServe RAID, but 
then again, that much hardware is not what you are looking For 
in the scenario we are assuming for this review* 

Also, ai NAB 2007, AMCC announced that support for 
Windows systems was now available for the 3ware Sidecar This 
Opens up more options if your backend is running on Window's 
Server. You can still get RAID level storage made available to 
your Mac desktops that way. 

The base unit, that does not include disk drives, costs 
$1295, and can l>e purchased directly from AMCC, as well as a 
few resellers. Tills allows you to add whatever size drives you 
need to complete the unit. 

The AMCC unit is a very good starting jxnnt for moving into 
RAID quality storage. Tire price is not unreasonable, and the 
options the unit provides, as well as the reporting capabilities, 
make this product an excellent di«lice for moving from basic 
storage to fault tolerant, and better performing, RAID storage* 
www.3ware.com 
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continued from p.00 

In terms of changing Apple itself, without question I'd like to 
change their culture of secrecy. Users aim't terriHy affected by this, 
they just get surprised when Apple unveils a major new' product 
like the iPod However, as far as being a developer on the platform, 
getting information and details on anything from Apple is like 
pulling teeth, from bug reporting to specifications of existing and 
upcoming products, we've always liad a hard time getting to the 
people we need at Apple through wliaL few established channels 
exist. Hi is is sort of accepted by the Mac development community, 
but Apple’s complete lack of communication with its third-party 
developers is far from the norm with must companies. 

What's the coolest tech thing you've done using OS X? 

I'll use this to talk about something we did at Hogue Amoeba. 
When working on Airfoil 2, back at the end of 2005, we decided to 
attempt to add support for sending audio to multiple AirPott Express 
units. And while it is straightforward to send audio to multiple units, 
keeping die playback between litem properly synchronized, is not. 
Quentin worked a great deal trying to rind a way to synchronize 
audio with the limited options provided by the AirTunes protocol, 
After about two months of research, a way was found by reading 
unckxumented quality-of-service reports from die Airport Express, 
combined with an audio stretching shrinking algorithm It worked, 
but was eventually fall out of sync At this point Mike Ash took over, 
and sjsent another month working on some high-level math 10 get 
units working nearly perfectly in sync with one another 

We released this January 7th, with the hopes of revolutionizing 
the way people used AirPort Express units. On January 10th, Apple 


released iTunes 6.0.2 with AirTunes 2, which quietly added support 
for multiple synchronized units as well To solve the 
synchronization problem, they completely redid the AirTunes 
protocol (called AirTunes 2), to support synchronization natively. 

We were eventually told by Apple, that they didn't believe 
synchronization with AirTunes 1 was possible, at all. So we had 
achieved the impossible, but no one ever knew. 

Where can we see a sample of your work? 

The software I've worked with everyone at 
Rogue Amoeba to create, is available on our website at 
http://www.rogueomoeba.com/. Free trials of all our software 
can be downloaded there, and license keys can lie purchased 
through our online store. 

Hie next way I'm going to impact IT/OS TO'the Mac 
universe Is: 

I think Hogue Amoeba’s next product, as yet unannounced, 
will really have a major impact. Audio Hijack and Audio Hijack Pro 
have focused on recording in general. Wirii our next application, 
we're going back to Audio J lijack's routs and doing radio recording 
right. If you've ever watched and record 'IV with Tivo, you'll have 
some idea of what were doing. That'll Itc coming in the first quarter 
of 2007, and we're really excited 

Anything else we should know? 

I hope people will check mu our software, we've got free trials 
of all of it, as well as several useful Freebies, If that's not interesting 
enough, we’ve also got stylish t-shirts and plush toys of our mascot 
Ammo, http://www.rogueamoeba.com/merchandi5e/ 
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Your Company? 

Rogue Amoeba Software 

What do you do? 

My official title is CEO/Lackey, which makes me ihe high and 
low man on the corporate ladder here. Essentially, it's my job to make 
sure the programmers can keep on programming. That means 1 
handle product management, business development, marketing, 
website content, some support, and much more, 

How long have you been doing what you do? 

I've lieen working for Rogue Amoeba since we founded it in 
2002. I've been handling various aspects of software development (at 
other companies) for about 8 years total, but Rogue Amoeba lias been 
by far the most successful. 

Your first computer: 

My first computer was a Mat Plus, in about I987 t with 8 
blistering Mliz of CPI J power. 

Are you Mac-only, or a multi-platform person? 

As .far as my personal use,ita on the Mac, undhaivc 

been since that Mac Plus 1 have various levels of understanding of 
l nix, Linux Solaris and Windows, from working support jobs in 
college, and Rogue Amoeba lias one Windows port (of Airfoil) that I 
use a cheap Del! to test. That Dell spends 95% of the day turned off, 
secretly wishing it was a Mac. 

What attracts you to working on the Mac? 

I never sat down and said 'I'm going to develop software, and 
Tin going to do it on the Mad'. It happened organically - everyone at 
Rogue Amoeba uses a Mac, so naturally we develop for the Mac. 

There certainly are things that make it exciting and keep us here 
on the Mac. however First and foremost, the user community is great 
in terms of purchasing and supporting third party softwafeTreople 
often assume if we developed for Windows, we'd have much higher 
sales volume. Howler, it seems that far fewer Windows users 
purchase third party software, and there are often many alternatives 
and competitors the user base may lx much larger, but drat doesn't 
instantly mean .success. 

As well, OS X is a great platform to develop on. It's young, it's 
fresh, and it's constantly being updated with new technologies. When 
we first started developing on it (in 10.0), it was a wide open playing 
held - no one wanted to run Classic if they could avoid it/ so old 
applications could lx remade and reworked, and new ideas could lx 

explored* 

Whads the coolest thing about the Mac? 

I hear this question a lot, and 1 don't think there's one specific 
thing. It's not "the Dock* or "great third party Software 1 '. For me, the 
best part alx>ut the whole Apple experience is the attention to detail. 

My MacBook's MagSafe connector is a perfect example of Lifts - 
I’ve [personally pulled at least one laptop oil a table by tripping over 
the power cord, But never again, Ihe accessible case (if the G3/G4 
towers, the scrolling-'track pad of newer laptops, the built-in iSight 
they all represent dft attention to detail and the way users work that 
I just don't see evident In other machines. 

If I could change one tiling about Apple/OS X, I'd: 

Tl lis question is a setup for disaster and retaliation. isn't it? As far 
as OS X goes, I'd like to see a new/rewritten Finder. 

continued on page 78 
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ALWAYS BY YOUR SIDE. 


Small Dog Electronics is the third largest Apple Specialist in the US. We offer over 
4000 Mac-compatible products, including new and Apple Refurbished Xserves, Xserve 
RAID’s, RAM, hard drives, networking gear, and much more. 

We’ve earned our place in the Apple community with our superior customer service, 
great prices, socially responsible mission, and by staying true to the Apple platform. 


We are here to help you. Give us a call, or visit us at Smalldog.com! 


Small Dog Electronics is 100% Mac-based. We’re powered by: 

14 Xserves + 4 G4 Servers + 3 T1 lines + Heaps of Cisco Routers + 4 Miles of CAT 5 
*13 kW Propane Back-up Generator +13 Network Cameras + 1 Firewall + 50 Mac 
Workstations + 41 Apple Product Professionals + 14 dogs of all shapes and sizes! 

Call for a free custom quote for home or business! 



Small Do$ 

Electronics 

Always by your side. 


i/vww.smalldog.com 800-511 -MACS 
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